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Preface 


The OpenVMS System Management Utilities Reference Manual: A-L contains 
reference information about the utilities that are used to manage both the 
OpenVMS VAX and OpenVMS Alpha operating systems. This manual describes 
each system management utility and provides examples for frequently used 
commands and qualifiers. In addition to system management utilities, a 
description and usage summary of the AUTOGEN command procedure is 
presented in this reference manual. 

Refer to the OpenVMS System Management Utilities Reference Manual: M-Z for 
information on the system management utilities not discussed in this book. 

All commands follow the standard rules of grammar as specified in the OpenVMS 
DCL Dictionary. 

For information on how to use these system management utilities and 
AUTOGEN, please refer to the OpenVMS System Manager’s Manual. 

Intended Audience 

This manual is intended for system managers and users of the system 
management utilities for the OpenVMS VAX and OpenVMS Alpha operating 
systems. 

Document Structure 

This manual has 14 parts, arranged alphabetically. Each part, except the section 
on the AUTOGEN command procedure, contains reference information for a 
system management utility. Table 1 shows the structure. 

Table 1 Manual Structure 

Part Utility 

1 Access Control List Editor (ACL editor) 

2 Accounting (ACCOUNTING) 

3 Analyze Disk/Disk Structure (ANALYZE/DISK_STRUCTURE) 

4 Audit Analysis (ANALYZE/AUDIT) 

5 Authorize (AUTHORIZE) 

6 AUTOGEN Command Procedure 

7 Backup (BACKUP) 

8 Crash Log Utility Extractor (CLUE) 

9 DECevent 


(continued on next page) 






Table 1 (Cont.) Manual Structure 


Part 


Utility 


10 

11 

12 

13 

14 


Error Log (ANALYZE/ERROR_LOG) 
Install (INSTALL) 

LAN Control Program (LANCP) 

LAT Control Program (LATCP) 

Log Manager Control Program (LMCP) 


Related Documents 


For more information on the system management utilities, please refer to the 
following documents: 

• DEC Text Processing Utility Reference Manual 

• OpenVMS AXP Guide to System Security 

• OpenVMS DCL Dictionary 

• OpenVMS System Manager’s Manual 

• OpenVMS System Management Utilities Reference Manual: M-Z 

• OpenVMS Programming Concepts Manual 

• OpenVMS Programming Interfaces: Calling a System Routine 

• OpenVMS Record Management Services Reference Manual 

• OpenVMS System Services Reference Manual 

• OpenVMS User’s Manual 

• OpenVMS VAX Device Support Manual 

• OpenVMS VAX Guide to System Security 

• OpenVMS VAX System Dump Analyzer Utility Manual 

• Volume Shadowing for OpenVMS 

• VAX Hardware Handbook 


Conventions 


The name of the OpenVMS AXP operating system has been changed to OpenVMS 
Alpha. Any references to OpenVMS AXP or AXP are synonymous with OpenVMS 
Alpha or Alpha. 

The contents of the display examples for some utility commands described in this 
manual may differ slightly from the actual output provided by these commands 
on your system. However, when the behavior of a command differs significantly 
between OpenVMS VAX and OpenVMS Alpha, that behavior is described in text 
and rendered, as appropriate, in separate examples. 
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ACL Editor Description 

The access control list editor (ACL editor) is a screen-oriented editor used to 
create and maintain access control lists (ACLs). An ACL is a collection of access 
control entries (ACEs) that grant or deny access for specific users or groups of 
users of an object. (For a description of the entry and display format for ACEs, 
see the section ACE Formats.) ACLs enable you to control access more closely 
than you can by using the default user identification code (UIC) based protection. 

The system does not limit the number of ACEs that an ACL can contain or the 
number of characters in an ACE. However, long ACLs increase the amount of 
time necessary to gain access to an object. In practice, memory constraints can 
limit the size of an ACL. 

The order of ACEs in an ACL is important. ACEs granting or denying access to 
an object for specific users must appear before ACEs identifying broader classes 
of users. For example, to grant user SMITH read access to a system object and to 
deny all other interactive users all types of access to the object, place the ACE for 
user SMITH before the ACE identifying all interactive users on the system. 

You can place ACLs on the following object classes: 

Capability 

Common event flag cluster 

Device 

File 

Group global section 
Logical name table 
Queue 

Resource domain 
Security class 
System global section 
Volume 
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ACL Editor Usage Summary 

The access control list editor (ACL editor) creates or modifies an access control 
list (ACL) for a specified object. 

Format 

EDIT/ACL object-spec 

Parameter 

object-spec 

Specifies the object whose access control list is to be created or edited. If an 
access control list does not exist, it is created. 

You can specify an object from any of the following object classes: 

Capability 

Common event flag cluster 

Device 

File 

Group global section 
Logical name table 
Queue 

Resource domain 
Security class 
System global section 
Volume 

The default object class is a file. A file must be a disk file on a Files-11 On-Disk 
Structure Level 2 formatted volume. For any object other than a file, you must 
specify the object class with the /CLASS qualifier. 

Note that the ACL editor does not provide a default file type for files. To prevent 
the ACL editor from using a null file type, specify the file type on the command 
line. If the object is a directory, specify the .DIR file type. 

Do not include wildcard characters in the object specification. 

Usage Summary 

You can invoke the ACL editor to create or modify an ACL for an object that you 
own, have control access to, or can gain access to by a privilege such as BYPASS, 
GRPPRV, or SYSPRV. To invoke the ACL editor, enter the DCL command EDIT 
/ACL. In the command line, specify the name of the object whose ACL you want 
to edit. For example, to create an ACL for the file INVENTORY.DAT, enter the 
following command: 

$ EDIT/ACL INVENTORY.DAT 

You can use either the EDIT/ACL command or the SET SECURITY/EDIT 
command to invoke the ACL editor. For more information on the SET SECURITY 
command, see the OpenVMS DCL Dictionary and the OpenVMS Guide to System 
Security . 
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By default, the ACL editor creates and modifies ACLs for files. To create an ACL 
for an object other than a file (for example, to create an ACL for a queue), you 
must specify the object class when you invoke the ACL editor. For example, the 
following command invokes the ACL editor to create an ACL for the disk DAPR: 

$ EDIT/ACL/CLASS=DEVICE DAPR 

If an ACL for the object you specify already exists, the ACL editor displays the 
ACL. You can then use keypad editing commands to add, replace, or delete one 
or more ACEs in the ACL (see Section A.1). To exit from a completed editing 
session, press Ctrl/Z. To end an editing session without incorporating any of your 
edits, press the GOLD key (PF1) and then press Ctrl/Z. 

For a description of keypad editing commands supplied by the ACL editor, see 
Appendix A. For information on how to modify the ACL editor by modifying ACL 
section files, see Appendix B. 

--- Note _ 

In addition to invoking the ACL editor directly or by entering commands 
at the DCL prompt ($), you can also modify an ACL by using the 
callable interface to the ACL editor (the ACLEDIT$EDIT routine). For 
information about how to use the ACLEDIT$EDIT routine, see the 
OpenVMS Utility Routines Manual. 
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ACE Formats 

This section describes the entry and display format for the following access 
control entries (ACEs): 

• Alarm ACE for security auditing of an object 

• Audit ACE for security auditing of an object 

• Creator ACE to set the ownership access for new files created in a directory 

• Default Protection ACE to set a default protection code through a directory 
structure 

• Identifier ACE for object access control 

• Subsystem ACE for protected subsystem access control 

The OpenVMS Guide to System Security describes how to use each of these ACEs. 
You can also use other types of ACEs. For example, applications can use an 
Application ACE to store application-specific information associated with a file. 
For a description of the internal format used to store an ACE, see the OpenVMS 
Programming Concepts Manual. 


Alarm ACE 

Specifies the access criteria that cause an alarm message to be sent to all security 
operator terminals. 

ACL alarms are enabled by default; however, alarms are not written to the 
system security audit log file. If you have existing files or resources protected by 
Alarm ACEs and you want messages to be recorded in the log file, replace the 
Alarm ACEs with Audit ACEs. 

Format 

(ALARM=SECURITY [,OPTIONS=attributes], ACCESS=access-type[+access-type...]) 

Parameters 

options 

Specify any 

Default 


of the following attributes: 

Indicates that an ACE is to be included in the ACL of 
any files created within a directory. When the entry is 
propagated, the Default attribute is removed from the ACE 
of the created file. This attribute is valid for directory files 
only. 
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Hidden 

Indicates that this ACE should be changed only by the 
application that adds it. Although the Hidden attribute 
is valid for any ACE type, its intended use is to hide 
Application ACEs. To delete or modify a hidden ACE, you 
must use the SET SECURITY command. 

Users need the SECURITY privilege to display a hidden 
ACE with the DCL commands SHOW SECURITY or 
DIRECTORY/SECURITY. SECURITY privilege is also 
required to modify or delete a hidden ACE with the DCL 
command SET SECURITY. The ACL editor displays the 
ACE only to show its relative position within the ACL, not 
to facilitate editing of the ACE. To create a hidden ACE, 
an application can invoke the $SET_SECURITY system 
service. 

Protected 

Protects the ACE against casual deletion. Protected ACEs 
can be deleted only in the following ways: 

• By using the ACL editor 

• By specifying the ACE explicitly when deleting it 

Use the command SET SECURITY/ACL=(ace)/DELETE 
to specify and delete an ACE. 

• By deleting all ACEs, both protected and unprotected 
Use the command SET SECURITY/ACL/DELETE=ALL 
to delete all ACEs. 

The following commands do not delete protected ACEs: 

SET SECURITY/ACL/DELETE 

SET SECURITY/LIKE 

SET SECURITY/DEFAULT 

Nopropagate 

Indicates that the ACE cannot be copied by operations that 
usually propagate ACEs. For example, the ACE cannot be 
copied by the SET SECURITY/LIKE or SET SECURITY 
/DEFAULT commands. 

None 

Indicates that no attributes apply to an entry. Although 
you can create an ACL entry with OPTIONS=None, the 
attribute is not displayed. Whenever you specify additional 
attributes with the None attribute, the other attributes take 
precedence. The None attribute is equivalent to omitting 
the field. 

access 



Specify any access that is valid for the object class. See the OpenVMS Guide to 
System Security for a listing of valid access types. For an Alarm ACE to have 
any effect, you must include the keywords SUCCESS, FAILURE, or both with the 
access types. For example, if the auditing criterion is a failure to obtain write 
access to an object, specify the following Alarm ACE: 

(ALARM=SECURITY, ACCESS=WRITE+FAILURE) 
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Audit ACE 


Specifies the access criteria that cause an audit message to be written to the 
system security audit log file. A message is recorded by default. A message is 
recorded only if ACL audits are enabled with the DCL command SET AUDIT 
/AUDIT/ENABLE=ACL. 

Format 

(AUDIT=SECURITY [,OPTIONS=attributes], ACCESS=access-type[+access-type...]) 

Parameters 

options 

Specify one of the following attributes: 

Default Indicates that an ACE is to be included in the ACL of 

any files created within a directory. When the entry is 
propagated, the Default attribute is removed from the ACE 
of the created file. This attribute is valid for directory files 
only. 

Hidden Indicates that this ACE should be changed only by the 

application that adds it. Although the Hidden attribute 
is valid for any ACE type, its intended use is to hide 
Application ACEs. To delete or modify a hidden ACE, you 
must use the SET SECURITY command. 

Users need the SECURITY privilege to display a hidden 
ACE with the DCL commands SHOW SECURITY or 
DIRECTORY/SECURITY. SECURITY privilege is also 
required to modify or delete a hidden ACE with the DCL 
command SET SECURITY. The ACL editor displays the 
ACE only to show its relative position within the ACL, not 
to facilitate editing of the ACE. To create a hidden ACE, 
an application can invoke the $SET_SECURITY system 
service. 
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Protected Protects the ACE against casual deletion. Protected ACEs 

can be deleted only in the following ways: 

• By using the ACL editor 

• By specifying the ACE explicitly when deleting it 
Use the command SET SECURITY/ACL=(ace)/DELETE 
to specify and delete an ACE. 

• By deleting all ACEs, both protected and unprotected 
Use the command SET SECURITY/ACL/DELETE=ALL 
to delete all ACEs. 

The following commands do not delete protected ACEs: 

SET SECURITY/ACL/DELETE 
SET SECURITY/LIKE 
SET SECURITY/DEFAULT 

Indicates that the ACE cannot be copied by operations that 
usually propagate ACEs. For example, the ACE cannot be 
copied by the SET SECURITY/LIKE or SET SECURITY 
/DEFAULT commands. 

Indicates that no attributes apply to an entry. Although 
you can create an ACL entry with OPTIONS=None, the 
attribute is not displayed. Whenever you specify additional 
attributes with the None attribute, the other attributes take 
precedence. The None attribute is equivalent to omitting 
the field. 


Nopropagate 


None 


access 

Specify any access that is valid for the object class. See the OpenVMS Guide to 
System Security for a listing of valid access types. For an Audit ACE to have any 
effect, you must include the keywords SUCCESS, FAILURE, or both with the 
access types. For example, if the auditing criterion is a failure to obtain write 
access to an object, specify the following Audit ACE: 

(AUDIT=SECURITY,ACCESS=WRITE+FAILURE) 


Creator ACE 


Adds an extra ACE to the ACL for a file created within the directory to which 
you assign the Creator ACE. The Creator ACE applies only when the following 
conditions exist: 

• The file being created is not owned by the user identification code (UIC) of the 
process creating the file. 

• The process creating the file does not have system privileges. 

For example, both of these conditions exist when a process holding a general 
identifier with the Resource attribute creates a file in a directory owned by that 
identifier. In this situation, the system adds an extra ACE at the top of the new 
file’s ACL. If a Creator ACE exists in the ACL for the parent directory, the system 
propagates the access specified in the Creator ACE to the new ACE. If a directory 
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lacks a Creator ACE, the system assigns an extra ACE with a combination of 
control access and ownership access. A Creator ACE with ACCESS=NONE 
suppresses the addition of the extra ACE. 

The Creator ACE applies to directory files only. 

See the OpenVMS Guide to System Security for more information. 

Format 

(CREATOR [,OPTIONS=attribute[+attribute...]] 

, ACCESS=access-type[+access-type...]) 


Parameters 


options 

Specify any of the following attributes: 

Protected Protects the ACE against casual deletion. Protected ACEs 

can be deleted only in the following ways: 

• By using the ACL editor 

• By specifying the ACE explicitly when deleting it 

Use the command SET SECURITY/ACL=(ace)/DELETE 
to specify and delete an ACE. 

• By deleting all ACEs, both protected and unprotected 
Use the command SET SECURITY/ACL/DELETE=ALL 
to delete all ACEs. 

The following commands do not delete protected ACEs: 

SET SECURITY/ACL/DELETE 
SET SECURITY/LIKE 
SET SECURITY/DEFAULT 

Indicates that the ACE cannot be copied by operations that 
usually propagate ACEs. For example, the ACE cannot be 
copied by the SET SECURITY/LIKE or SET SECURITY 
/DEFAULT commands. 

Indicates that no attributes apply to an entry. Although 
you can create an ACL entry with OPTIONS=None, the 
attribute is not displayed. Whenever you specify additional 
attributes with the None attribute, the other attributes take 
precedence. The None attribute is equivalent to omitting 
the field. 

access 

Specify access types that are valid for files (read, write, execute, delete, and 
control). 


Nopropagate 


None 
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Default Protection ACE 


Defines a UlC-based protection to be propagated to new files throughout a 
directory tree. The protection code in the ACE is assigned to new files created in 
the directory. The Default Protection ACE applies to directory files only. 

Although the system propagates the Default Protection ACE to new 
subdirectories, the protection code is not assigned to the subdirectories. Instead, 
the subdirectories receive a modified copy of the parent directory’s protection code 
in which delete access is not granted. 

An example of a Default Protection ACE is as follows: 

(DEFAULT_PROTECTION,S:RWED,0:RWED,G,W) 

The ACE grants read, write, execute, and delete access to users in the system (S) 
and owner (O) categories but no access to users in the group and world categories. 
For more information, see the OpenVMS Guide to System Security. 

Format 

(DEFAULT_PROTECTION[,OPTIONS=attribute[+attribute...]],access) 

Parameters 

options 

Specify any of the following attributes: 

Hidden Indicates that this ACE should be changed only by the 

application that adds it. Although the Hidden attribute 
is valid for any ACE type, its intended use is to hide 
Application ACEs. To delete or modify a hidden ACE, you 
must use the SET SECURITY command. 

Users need the SECURITY privilege to display a hidden 
ACE with the DCL commands SHOW SECURITY or 
DIRECTORY/SECURITY. SECURITY privilege is also 
required to modify or delete a hidden ACE with the DCL 
command SET SECURITY. The ACL editor displays the 
ACE only to show its relative position within the ACL, not 
to facilitate editing of the ACE. To create a hidden ACE, 
an application can invoke the $SET_SECURITY system 
service. 
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Protected Protects the ACE against casual deletion. Protected ACEs 

can be deleted only in the following ways: 

• By using the ACL editor 

• By specifying the ACE explicitly when deleting it 

Use the command SET SECURITY/ACL=(ace)/DELETE 
to specify and delete an ACE. 

• By deleting all ACEs, both protected and unprotected 
Use the command SET SECURITY/ACL/DELETE=ALL 
to delete all ACEs. 

The following commands do not delete protected ACEs: 

SET SECURITY/ACL/DELETE 
SET SECURITY/LIKE 
SET SECURITY/DEFAULT 

Nopropagate Indicates that the ACE cannot be copied by operations that 

usually propagate ACEs. For example, the ACE cannot be 
copied by the SET SECURITY/LIKE or SET SECURITY 
/DEFAULT commands. 

None Indicates that no attributes apply to an entry. Although 

you can create an ACL entry with OPTIONS=None, the 
attribute is not displayed. Whenever you specify additional 
attributes with the None attribute, the other attributes take 
precedence. The None attribute is equivalent to omitting 
the field. 

access 

Specify access in the format of a UlC-based protection code, which is as follows: 
[category: list of access allowed (, category: list of access allowed,...)] 

• User categories include system (S), owner (O), group (G), and world 

(W). See the OpenVMS Guide to System Security for a definition of these 
categories. Access types for files include read (R), write (W), execute (E), 
and delete (D). The access type is assigned to each ownership category and 
is separated from its access types with a colon (:). 

• A null access list means no access, so when you omit an access type for a user 
category, that category of user is denied that type of access. To deny all access 
to a user category, specify the user category without any access types. Omit 
the colon after the user category when you deny access to a category of users. 

• When you omit a user category from a protection code, the current access 
allowed that category of user is set to no access. 
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Identifier ACE 

Controls the type of access allowed to a particular user or group of users. An 
example of an Identifier ACE is as follows: 

(IDENTIFIER=SALES,ACCESS=READ+WRITE) 

A system manager can use the Authorize utility (AUTHORIZE) to grant the 
SALES identifier to a specific group of users. Read and write access to the file 
INVENTORY.DAT is then granted to users who hold the SALES identifier. 

For more information, see the OpenVMS Guide to System Security. 

Format 

(IDENTI FI E R=identifier[+identifier...] [,OPTIONS=attributes[+attributes...]] 

, ACCESS=access-type[+access-type...]) 

Parameters 

identifier 

Specifies a user or groups of users whose access to an object is defined in the 
ACE. A system manager creates or removes identifiers and assigns users to hold 
these identifiers. 

Types of identifiers are as follows: 

Identifiers in alphanumeric format that are based on 
the user identification codes (UICs) and that uniquely 
identify each user on the system. Users with accounts 
on the system automatically receive a UIC identifier, for 
example, [GROUP1,JONES] or [JONES], Thus, each UIC 
identifier specifies a particular user. 

Identifiers defined by the security administrator in the 
rights list to identify groups of users on the system. 

A general identifier is an alphanumeric string of 1 
to 31 characters, containing at least one alphabetic 
character. It can include the letters A to Z, dollar signs 
($), underscores (_), and the numbers 0 to 9, for example, 
92SALES$, ACCOUNT_3, or PUBLISHING. 

Identifiers describing different types of users based 
on their initial entry into the system. Environmental 
identifiers are also called system-defined identifiers. 
Environmental identifiers correspond directly to the 
login classes described in the OpenVMS Guide to System 
Security. They include batch, network, interactive, local, 
dialup, and remote. 

For more information, see the OpenVMS Guide to System Security. 

options 

Specify any of the following attributes: 


UIC 


General 


Environmental 


1-13 







ACL Editor 
Identifier ACE 


Default 

Indicates that an ACE is to be included in the ACL of 
any files created within a directory. When the entry is 
propagated, the Default attribute is removed from the ACE 
of the created file. This attribute is valid for directory files 
only. 

Note that an Identifier ACE with the Default attribute has 
no effect on access. 

Hidden 

Indicates that this ACE should be changed only by the 
application that adds it. Although the Hidden attribute 
is valid for any ACE type, its intended use is to hide 
Application ACEs. To delete or modify a hidden ACE, you 
must use the SET SECURITY command. 

Users need the SECURITY privilege to display a hidden 
ACE with the DCL commands SHOW SECURITY or 
DIRECTORY/SECURITY. SECURITY privilege is also 
required to modify or delete a hidden ACE with the DCL 
command SET SECURITY. The ACL editor displays the 

ACE only to show its relative position within the ACL, not 
to facilitate editing of the ACE. To create a hidden ACE, 
an application can invoke the $SET_SECURITY system 
service. 

Protected 

Protects the ACE against casual deletion. Protected ACEs 
can be deleted only in the following ways: 

• By using the ACL editor 

• By specifying the ACE explicitly when deleting it 

Use the command SET SECURITY/ACL=(ace)/DELETE 
to specify and delete an ACE. 

• By deleting all ACEs, both protected and unprotected 
Use the command SET SECURITY/ACL/DELETE=ALL 
to delete all ACEs. 

The following commands do not delete protected ACEs: 

SET SECURITY/ACL/DELETE 

SET SECURITY/LIKE 

SET SECURITY/DEFAULT 

Nopropagate 

Indicates that the ACE cannot be copied by operations that 
usually propagate ACEs. For example, the ACE cannot be 
copied by the SET SECURITY/LIKE or SET SECURITY 
/DEFAULT commands. 

None 

Indicates that no attributes apply to an entry. Although 
you can create an ACL entry with OPTIONS=None, the 
attribute is not displayed. Whenever you specify additional 
attributes with the None attribute, the other attributes take 
precedence. The None attribute is equivalent to omitting 
the field. 

access 



Specify access types that are valid for the object class. See the OpenVMS Guide 
to System Security for a listing of valid access types. 
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Subsystem ACE 


Grants additional identifiers to a process while it is running the image to which 
the Subsystem ACE applies. Users with execute access to the image can access 
objects that are in the protected subsystem, such as data files and printers, 
but only when they run the subsystem images. The Subsystem ACE applies to 
executable images only. 

An example of a Subsystem ACE is as follows: 

(SUBSYSTEM, IDENTIFIER=ACCOUNTING) 

Format 

(SUBSYSTEM,[OPTIONS=attribute[+attribute...],]IDENTIFIER=identifier 
[,ATTRIBUTES=attribute[+attribute...]] [,IDENTIFIER=identifier 
[,ATTRIBUTES=attribute[+attribute...]],...]) 


Parameters 


options 

Specify any of the following attributes: 

Protected Protects the ACE against casual deletion. Protected ACEs 

can be deleted only in the following ways: 

• By using the ACL editor 

• By specifying the ACE explicitly when deleting it 

Use the command SET SECURITY/ACL=(ace)/DELETE 
to specify and delete an ACE. 

• By deleting all ACEs, both protected and unprotected 
Use the command SET SECURITY/ACL/DELETE=ALL 
to delete all ACEs. 

The following commands do not delete protected ACEs: 

SET SECURITY/ACL/DELETE 
SET SECURITY/LIKE 
SET SECURITY/DEFAULT 

Nopropagate Indicates that the ACE cannot be copied by operations that 

usually propagate ACEs. For example, the ACE cannot be 
copied by the SET SECURITY/LIKE or SET SECURITY 
/DEFAULT commands. 

None Indicates that no attributes apply to an entry. Although 

you can create an ACL entry with OPTIONS=None, the 
attribute is not displayed. Whenever you specify additional 
attributes with the None attribute, the other attributes take 
precedence. The None attribute is equivalent to o mi tting 
the field. 
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identifier 

A general identifier specifying the users or groups of users who are allowed 
or denied access to an object. It is an alphanumeric string of 1 through 31 
characters, containing at least one alphabetic character. It can include the letters 
A to Z, dollar signs ($), underscores (_), and the numbers 0 to 9. For more 
information, see the OpenVMS Guide to System Security. 

A Subsystem ACE can have multiple pairs of identifiers, with special attributes 
assigned to the identifiers. A subsystem might require several identifiers to work 
properly. For example: 

(SUBSYSTEM,IDENTIFIER=MAIL_SUBSYSTEM,ATTRIBUTE=NONE,IDENTIFIER=BLDG5,ATTRIBUTE=NONE) 

attribute 

The identifier characteristics you specify when you add identifiers to the rights 
list or grant identifiers to users. You can specify the following attribute: 

Resource Allows holders of the identifier to charge disk space to 

the identifier. Used only for file objects. 
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ACL Editor Qualifiers 

When you invoke the ACL editor, you can include qualifiers on the command line 
that identify the object class and the editing mode (prompt or noprompt). You can 
also use qualifiers to name a journaling file or to recover an ACL editing session. 
This section describes the qualifiers listed in Table 1—1. 


Table 1-1 ACL Editor Qualifiers 


Qualifier 

Description 

/CLASS 

Specifies the class of object whose ACL is being edited 

/JOURNAL 

Controls whether a journal file is created for the editing 
session 

/MODE 

Specifies the use of prompting during the editing session 

/OBJECT.TYPE 

Superseded by the /CLASS qualifier 

/RECOVER 

Restores an ACL from a journal file at the beginning of 
an editing session 


All of the qualifiers described in this section also apply to the SET SECURITY 
/EDIT command. You can substitute the SET SECURITY/EDIT command 
wherever the EDIT/ACL command is shown; the syntax is the same for both 
commands. 


/CLASS 

Specifies the class of the object whose ACL is being edited. Unless the object is a 
file, you must specify the object class. 

Format 

/CLASS =object-class 


Description 


To edit the ACL for an object other than a file, specify the object class with the 
/CLASS qualifier. Specify one of the following classes: 


CAPABILITY 


COMMON_EVENT_CLUSTER 

DEVICE 

FILE 

GROUP_GLOBAL_SECTION 

LOGICAL_NAME_TABLE 


A system capability, such as the ability to 
process vector instructions. Currently, the 
only defined object name for the CAPABILITY 
class is VECTOR, which governs the ability 
of a subject to access a vector processor on 
the system. Note that you must supply the 
capability name as the object name parameter. 

A common event flag cluster. 

A device, such as a disk or tape drive. 

A file or a directory file. This is the default. 

A group global section. 

A logical name table. 
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QUEUE 

RESOURCE_DOMAIN 

SECURITY.CLASS 

SYSTEM_GLOBAL_SECTION 

VOLUME 


A batch queue or a device (printer, server, or 
terminal) queue. 

A resource domain. 

A security class. 

A system global section. 

A disk or tape volume. 


Examples 


1. $ EDIT/ACL/CLASS=DEVICE W0RK1 

The command in this example specifies that the object WORK1 is a device. 

2. $ EDIT/ACL/CLASS=QUEUE FAST_BATCH 

The command in this example creates an ACL for the queue FAST_BATCH. 
Note that if you create an ACL for a generic queue, you must create identical 
ACLs for all execution queues to which jobs can be directed. 


/JOURNAL 

Controls whether a journal file is created for the editing session. 

Format 

/JOURNAL [=file-spec] 

/NOJOURNAL 

Description 

By default, the ACL editor keeps a journal file containing a copy of modifications 
made during an editing session. The journal file is given the name of the object 
and a .TJL file type. If you specify a different name for the file, do not include 
any wildcard characters. 

To prevent the ACL editor from creating a journal file, specify /NO JOURNAL. 

If your editing session ends abnormally, you can recover the changes made during 
the aborted session by invoking the ACL editor with the /RECOVER qualifier. 

Example 


$ EDIT/ACL/JOURNAL=COMMONACL.SAV MECH1117.DAT 

With this command, you create a journal file named COMMONACL.SAV. The file 
contains a copy of the ACL and the editing commands used to create the ACL for 
the file MECH1117.DAT. 

If the editing session is interrupted, you can recover your edits by specifying the 
name COMMONACL.SAV with the /RECOVER qualifier. 

$ EDIT/ACL/CLASS=RESOURCE/JOUENAL=ZERO_RESOURCE.TJL [0] 

If you edit an ACL for the resource domain [0], the ACL editor attempts to 
create the file LOj.TJL on the default device and fails. To create an ACL for the 
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resource [0], you must specify a different name for the journal file (as shown in 
this example) or suppress the creation of a journal file with the /NO JOURNAL 
qualifier. 


/MODE 


Specifies the use of prompting during the editing session. 

Format 


/MODE =option 


Description 

By default, the ACL editor prompts you for each ACE and provides values for 
some of the fields within an ACE (/MODE=PROMPT). To disable prompting, 
specify /MODE=NOPROMPT on the command line. 


Example 

$ EDIT/ACL/M0DE=N0PR0MPT WEATHERTBL.DAT 

With this command, you initiate an ACL editing session to create an ACL for the 
file WEATHERTBL.DAT. The /MODE=NOPROMPT qualifier specifies that no 
assistance is required in entering the ACL entries. 


/OBJECTTYPE 


The /OBJECT_TYPE qualifier is superseded by the /CLASS qualifier. 


/RECOVER 


Restores an ACL from a journal file at the beginning of an editing session. 

Format 

/RECOVER [=file-spec] 

/NORECOVER 


Description 

The /RECOVER qualifier specifies that the ACL editor must restore the ACL from 
a journal file. The ACL editor restores the ACL to the state it was in when the 
last ACL editing session ended abnormally. 

By default the journal file is given the name of the object and a .TJL file type. If 
you specify a more meaningful name for the journal file when you invoke the ACL 
editor (by using /JOURNAL), specify that file name with the /RECOVER qualifier. 
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Example 

$ EDIT/ACL/JOURNAL=SAVEACL MYFILE.DAT 

User creates ACL until system crashes 

$ EDIT/ACL/JOURNAL=SAVEACL/REC0VER= SAVEACL MYFILE.DAT 


ACL is restored and user proceeds with editing until done 


A Z 

$ 

The first command in this example starts the ACL editing session and specifies 
that the ACL editor must save the journal file SAVEACL.TJL if the session ends 
abnormally. The session proceeds until it is aborted by a system crash. 

The next command restores the lost session with the journal file SAVEACL.TJL. 
To end the session, press Ctrl/Z. The ACL editor saves the edits and deletes the 
journal file. 
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ACCOUNTING Description 

The Accounting utility (ACCOUNTING) produces reports of system resource use. 
You can use ACCOUNTING qualifiers to: 

• Produce a number of report formats 

• Choose how the reports are organized 

• Choose on which resources you want reports 

You can use the reports to learn more about how the system is used and how it 
performs. 
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Produces reports of resource use. 

Format 

ACCOUNTING [filespec[,...]] 

Parameter 

filespec[,...] 

Specifies the accounting files you want to process. 

Each file specification can include the percent (%) and asterisk (*) wildcard 
characters. If it does not include the device or directory, your current default 
device or directory is used. If it does not include the file name or file type, the 
values ACCOUNTNG and DAT are used respectively. 

If you do not specify a file, the command processes the file 
SYS$MANAGER:ACCOUNTNG.DAT. 

Usage Summary 

Use this DCL command to run the Accounting utility: 

$ ACCOUNTING [filespec[,...]] 

You are returned to DCL level when the command has finished processing the 
specified accounting files. 

By default, the command directs its output to the current SYS$OUTPUT device. 
If you want to direct the output to a file, use the /OUTPUT qualifier. 

Requires READ access to the accounting files you specify, and to the directories 
containing them. 
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This section describes and provides examples of each ACCOUNTING qualifier. 
Table 2-1 summarizes the ACCOUNTING qualifiers. 

Table 2-1 ACCOUNTING Qualifiers 


Qualifier 

Description 

/ACCOUNT 

Selects or rejects records for the specified account names 

/ADDRESS 

Selects or rejects records for DECnet for Open VMS requests 
made by the specified nodes 

/BEFORE 

Selects all records time-stamped before the specified time 

/BINARY 

Copies the selected records to a new file in binary format 

/BRIEF 

Produces a brief report of the selected records 

/ENTRY 

Selects or rejects records for print and batch jobs with the 
specified queue entry numbers 

/FULL 

Produces a full report of the selected records 

/IDENT 

Selects or rejects records for the specified processes 

/IMAGE 

Selects or rejects records for the specified images 

/JOB 

Selects or rejects records for print and batch jobs with the 
specified job names 

/LOG 

Outputs informational messages 

/NODE 

Selects or rejects records for DECnet for OpenVMS requests 
made by the specified nodes 

/OUTPUT 

Specifies the output file 

/OWNER 

Selects or rejects records for subprocesses created by the 
specified processes 

/PRIORITY 

Selects or rejects records for the specified priority 

/PROCESS 

Selects or rejects records for the specified types of process 

/QUEUE 

Selects or rejects records for print or batch jobs executed by 
the specified queues 

/REJECTED 

Copies the rejected records to a new file 

/REMOTEJD 

Selects or rejects records for DECnet for OpenVMS requests 
made by the specified remote IDs 

/REPORT 

Specifies the resources that you want to summarize in a 
summary report 

/SINCE 

Selects all records time-stamped at or after the specified time 

/SORT 

Sorts the selected records 

/STATUS 

Selects or rejects records with the specified final exit status 
codes 

/SUMMARY 

Produces a summary report of the selected records 

/TERMINAL 

Selects or rejects records for interactive sessions at the 
specified terminals 

/TITLE 

Specifies the title shown on the first line of a summary report 

(continued on next page) 
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Table 2-1 (Cont.) ACCOUNTING Qualifiers 

Qualifier Description __ 

/TYPE Selects or rejects the specified types of record 

fUlC Selects or rejects records for the specified UICs 

/USER Selects or rejects records for the specified user names 


/ACCOUNT 

Selects or rejects records for the specified account names. 

Format 

/ACCOUNT=([-]account[,...]) 

Description 

The /ACCOUNT qualifier uses the value of the account field to select records for 
processing. This field is present in all records except file backward link and file 
forward link records. 

The /ACCOUNT qualifier selects only records that have the specified values in the 
account field. If you precede the values with a minus sign, it selects all records 
except those with the specified values. 

Table 2-2 shows the values stored in the account field of login failure and system 
initialization records. 


Table 2-2 Special Account Field Values 


Value 

Description 

<batch> 

Batch job login failure 

<det> 

Detached process login failure 

<login> 

Interactive login failure 

<net> 

Network login failure 

<start> 

System startup 


Note that when you specify these account field values as qualifier values, you 
must enclose them in quotes. Like all DCL commands, the ACCOUNTING 
command converts strings to uppercase unless they are enclosed in quotes. 


Examples 

1. $ ACCOUNTING /ACC0UNT=(SALES, QA) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records for the account names SALES and QA. 
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2. $ ACCOUNTING /ACCOUNT=(-SALES, QA) /FULL 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a full report of all records except for the account names SALES and 
QA. 


/ADDRESS 

Selects or rejects records for DECnet for OpenVMS requests made by the specified 
nodes. 

Format 

/ADDRESS=([-]node_address[,...]) 

Description 

The /ADDRESS qualifier uses the value of the remote node address field to select 
records for processing. This field is present in all records except file backward 
link and file forward link records. For records that contain information about 
DECnet for OpenVMS requests, it contains the address of the node that made the 
request. 

The /ADDRESS qualifier selects only records with the specified values in the 
remote node address field. If you precede the values with a minus sign, it selects 
all records except those with the specified values. 

See also the /NODE and /REMOTE_ID qualifiers, which select or reject records 
for DECnet for OpenVMS requests made by specified node names and remote IDs 
respectively. 

Example 

$ ACCOUNTING /ADDRESS=19656 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a brief report of all records for DECnet for OpenVMS requests made by the node 
with the address 19656. 


/BEFORE 


Selects all records time-stamped before the specified time. 

Format 

/BEFORE[=time] 

Description 

All records in an accounting file are time-stamped with the time the record was 
logged in the file. 

The /BEFORE qualifier selects only the records time-stamped before the specified 
time. You can specify an absolute time, a delta time, or a combination of the two. 
If you omit the time, 00:00 hours on the current day is used. 
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See also the /SINCE qualifier, which selects records time-stamped at or after a 
specified time. 


Example 

$ ACCOUNTING /SINCE=l-NOV-1994 /BEFORE=l-DEC-1994 

This example produces a brief report of all records time-stamped in the file 
SYS$MANAGER:ACCOUNTNG.DAT during November 1994. 


/BINARY 


Copies the selected records to a new file in binary format. 


Format 

/BINARY 

Description 

The /BINARY qualifier specifies that records are output in binary format to the 
file specified by the /OUTPUT qualifier. Use the Accounting utility to process this 
file later. 

See also the /BRIEF, /FULL, and /SUMMARY qualifiers, which process the 
selected records to produce a report. 

You cannot use the /BINARY qualifier with the /BRIEF, /FULL, or /SUMMARY 
qualifiers. 

Examples 

1. $ ACCOUNTING /USER=SMITH /BINARY /OUTPUT=MYDISK:[ACCOUNTING]MYACC.DAT 

This example creates the file MYDISK:[ACCOUNTING]MYACC.DAT. It 
processes the file SYS$MANAGER:ACCOUNTNG.DAT, copying all records for 
the user SMITH to the new file in binary format. 

2. $ ACCOUNTING /TYPE=PRINT - 

_$ /BINARY /OUTPUT=PRINT_INFO.DAT /REJECTED=NOT_PRINT_INFO.DAT 

This example creates two files in the default directory, 

PRINT_INFO.DAT and NOT_PRINT_INFO.DAT. It processes the 
file SYS$MANAGER:ACCOUNTNG.DAT, copying print records to 
PRINT_INFO.DAT and other records to NOT_PRINT_INFO.DAT. These 
records are in binary format. 
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/BRIEF 


Produces a brief report of the selected records. 

Format 

/BRIEF (default) 


Description 

The /BRIEF qualifier is the default. It produces a brief report of the selected 
records. The report is directed to the current SYS$OUTPUT device, unless you 
use the /OUTPUT qualifier to write it to a file. 

Each line of a brief report corresponds to a record in the accounting file. It does 
not show resources used, but gives the information shown in Table 2-3 about 
each record in the accounting file. 


Table 2-3 Information in a Brief Accounting Report 
Column Description 


Date/Time 

Type 

Subtype 


User name 
ID 

Source 


Status 


When the record was logged in the accounting file. 

The type of the record (see Table 2-5 for details of the different 
types of record). 

For records of type IMAGE, this is the name of the image (the 
file name portion of its file specification). For records of type 
PROCESS, it is the type of the process (BATCH, DETACHED, 
INTERACTIVE, NETWORK, or SUBPROCESS). 

The user name. For login failures where the user did not give a 
valid user name, this is shown as <login>. 

The process identification (PID). For print jobs, this is the PID of 
the process that submitted the job. 

The terminal associated with an interactive process or, for 
DECnet for Open VMS requests, the name of the node that issued 
the request. 

The final exit status code, expressed as a hexadecimal value. 


To translate the final exit status code into the equivalent message text, use the 
F$MESSAGE lexical function, and precede the status code with %X, as in this 
example: 

$ MESSAGE = F$MESSAGE(%X00000001) 

$ SHOW SYMBOL MESSAGE 

MESSAGE = "%SYSTEM-S-NORMAL, normal successful completion" 

See also the /BINARY qualifier, which copies the selected records to a file, and 
the /FULL and /SUMMARY qualifiers, which produce full and summary reports 
of the selected records. 

You cannot use the /BRIEF qualifier with the /BINARY, /FULL, or /SUMMARY 
qualifiers. 
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Example 

$ ACCOUNTING 

This example produces a brief report of all records in the file 
SYS$MANAGER:ACCOUNTNG.DAT. 

T his is an example of the report that is produced. 


Date / Time Type Subtype Username ID Source Status 


7-JAN-1995 17:20:08 FILE_BL 00000000 00000000 
7-JAN-1995 17:22:05 PROCESS DETACHED JONES 516000E1 02DBA002 
7-JAN-1995 17:22:10 PROCESS INTERACTIVE JONES 516000DD TWA10: 00000001 
7-JAN-1995 17:22:16 PROCESS INTERACTIVE JONES 51600104 TWAll: 0001C0F4 

7- JAN-1995 17:22:20 PROCESS DETACHED JONES 51600103 12DB821C 

8- JAN-1995 01:06:36 PROCESS SUBPROCESS SYSTEM 51600106 10000001 
8-JAN-1995 03:09:59 PROCESS BATCH SYSTEM 5160010F 10030001 
8-JAN-1995 09:13:15 LOGFAIL 51600105 00D3803C 
8-JAN-1995 09:14:40 IMAGE LOGINOUT JONES 51600110 00000000 
8-JAN-1995 09:28:57 PROCESS SUBPROCESS SMITH 51600119 10000001 
8-JAN-1995 09:50:18 PROCESS SUBPROCESS SMITH 5160011A 00000001 


/ENTRY 


Selects or rejects records for print and batch jobs with the specified queue entry 
numbers. 

Format 

/ENTRY=(He n t r y- numbe, t—1) 


Description 

The /ENTRY qualifier uses the value of the queue entry number field to select 
records for processing. This field is present in all records except file backward 
link and file forward link records. For records that contain information about 
print or batch jobs, it contains the unique entry number assigned to the job in the 
print or batch queue. 

The /ENTRY qualifier selects only records that have the specified values in the 
queue entry number field. If you precede the values with a minus sign, it selects 
all records except those with the specified values. 

See also the /JOB and /QUEUE qualifiers, which select or reject records for print 
and batch jobs with specified job and queue names. 


Examples 


1. $ ACCOUNTING /ENTRY= (211,212,213) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records for print or batch jobs with a queue 
entry number of 211, 212, or 213. 
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2. $ ACCOUNTING /ENTRY=(-25,50) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records except those for print or batch jobs with 
a queue entry number of 25 or 50. 


/FULL 


Produces a full report of the selected records. 

Format 

/FULL 

Description 

The /FULL qualifier produces a full report of the selected records. The report 
is directed to the current SYS$OUTPUT device, unless you use the /OUTPUT 
qualifier to write it to a file. 

Full reports display one screen of information for each selected record. The 
information displayed, and the way that it is laid out, depend on the type of the 
record and the data it contains. 

The first line shows the event that caused the record to be logged in the 
accounting file. For example, for a record that was logged when an interactive 
process terminated, the first line shows INTERACTIVE Process Termination. 

For subprocesses, the Owner ID field shows the PID of the parent process. 

For records that contain information about DECnet for Open VMS requests, the 
three Remote fields identify the remote user and remote node. 

The Processor time field shows the total CPU time used. This includes any vector 
CPU time used. The Vector CPU time field is shown only if vector CPU time has 
been used. 

Vector CPU time is the time that the process was scheduled on a vector-present 
CPU while that process was a vector consumer. Note that: 

• When a process is a vector consumer, it accrues vector CPU time when it is 
scheduled, even if it does not issue any vector instructions. 

• Processes that are scalar consumers or marginal vector consumers do not 
accrue vector CPU time, even when they are scheduled on vector-present 
CPUs. 

The privilege is shown as two hexadecimal numbers that represent the first and 
last 32 bits of the 64-bit privilege mask. To translate the privilege bit mask 
into privileges, refer to the definitions of the symbols that begin PRV$V_ in 
the $PRVDEF macro in the STARLET library. For example, the $PRVDEF 
macro defines the PRV$V_READALL symbol to equate to 35. This means that 
READALL privilege is represented by bit 35 set in the privilege mask. 

If you are processing only one file and you are displaying it on your screen, when 
you do not want to look at any more records, press Ctrl/Z to return to the DCL 
prompt. 
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See also the /BINARY qualifier, which copies the selected records to a file, and 
the /BRIEF and /SUMMARY qualifiers, which produce brief and summary reports 
of the selected records. 

You cannot use the /FULL qualifier with the /BINARY, /BRIEF, or /SUMMARY 
qualifiers. 

Examples 

1. $ ACCOUNTING /FULL 

This example displays a full report of all the records in the file 
SYS$MANAGER:ACCOUNTNG.DAT. This example screen shows a record 
that was logged when an interactive process terminated. The interactive 
process was created when the user JONES at the node HQ222 entered a SET 
HOST command to connect to the local node. 


INTERACTIVE Process Termination 


Username: 

FISH 

UIC: 

[DOC,FISH] 


Account: 

DOC 

Finish time: 

23-JAN-1995 

15:21:23.83 

Process ID: 

20A0029B 

Start time: 

23-JAN-1995 

15:19:08.28 

Owner ID: 


Elapsed time: 

0 

00:02:15.55 

Terminal name: RTA2: 

Processor time: 

0 

00:00:04.14 

Remote node 

addr: 63576 

Priority: 

4 


Remote node 

name: HQ222 

Privilege <31-00>: 

00108000 


Remote ID: 

JONES 

Privilege <63-32>: 

00000000 


Queue entry: 


Final status code: 

00000001 



Queue name: 

Job name: 

Final status text: %SYSTEM-S-NORMAL, normal successful completion 


Page faults: 2043 Direct 10: 159 
Page fault reads: 68 Buffered 10: 228 
Peak working set: 852 Volumes mounted: 0 
Peak page file: 5512 Images executed: 10 

Vector CPU time: 0 00:00:0.54 
Press RETURN for Next Record > 


2. $ ACCOUNTING /FULL /OUTPUT=MYACC 

This example creates the output file MYACC.LIS in the default directory. It 
processes the file SYS$MANAGER:ACCOUNTNG.DAT, writing a full report 
of all records to the new output file. 


/IDENT 


Selects or rejects records for the specified processes. 


Format 

/IDENT=([-]pid[,...]) 
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Description 

The /IDENT qualifier uses the value of the process identification (PID) field 
to select records for processing. This field is present in all records except file 
backward link and file forward link records. For print job records, it contains the 
PID of the process that submitted the job. 

The /IDENT qualifier selects only records that have the specified values in the 
PID field. If you precede the values with a minus sign, it selects all records except 
those with the specified values. 

See also the /OWNER qualifier, which selects or rejects records for subprocesses 
created by specified processes. 

Examples 


1. $ ACCOUNTING /IDENT=(25634,045A6B) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records for processes with a PID of 25634 or 
045A6B. 

2. $ ACCOUNTING /IDENT=(-25634,045A6B) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records except those for processes with a PID of 
25634 or 045A6B. 


/IMAGE 

Selects or rejects records for the specified images. 

Format 

/IMAGE=([-]image_name[,...]) 

Description 

The /IMAGE qualifier uses the value of the image name field to select records for 
processing. This field is present only in records of type IMAGE, and contains the 
name of the image. 

Note that the system does not track records of type IMAGE by default. To enable 
the tracking of IMAGE records, use the SET ACCOUNTING command. 

The /IMAGE qualifier selects only records that have the specified values in the 
image name field. If you precede the values with a minus sign, it selects all 
records except those with the specified values. 

Each image name is a string that gives the file name portion of the image file 
specification. Do not include the device, directory, or file type. 
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Examples 

1. $ ACCOUNTING /IMAGE=DIRECTORY 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records for the DIRECTORY.EXE image. 

2. $ ACCOUNTING /IMAGE=-DIRECTORY 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records except those for the DIRECTORY.EXE 
image. 


/JOB 


Selects or rejects records for print and batch jobs with the specified job names. 

Format 

/JOB=([-]job_name[,...]) 

Description 

The /JOB qualifier uses the value of the job name field to select records for 
processing. This field is present in all records except file backward link and file 
forward link records. For records that contain information about print and batch 
jobs, it contains the name of the job. 

The /JOB qualifier selects only records that have the specified values in the job 
name field. If you precede the values with a minus sign, it selects all records 
except those with the specified values. 

See also the /QUEUE and /ENTRY qualifiers, which select or reject records for 
print and batch jobs with specified queue names and queue entry numbers. 

Examples 


1. $ ACCOUNTING /JOB= (MYJ0B1, MYJ0B2) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records for print or batch jobs named MYJOB1 
or MYJOB2. 

2. $ ACCOUNTING /J0B=(-MYJ0B1,MYJ0B2) /FULL 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a full report of all records except those for print or batch jobs named 
MYJOB1 or MYJOB2. 
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/LOG 


Outputs informational messages. 


Format 

/LOG 

Description 

The /LOG qualifier outputs these informational messages to the current 
SYS$OUTPUT device: 

• For each file processed, the name of the file and the number of records 
selected and rejected from that file 

• If you use the /SORT qualifier, the total number of records merged in the 
sort (this is the total number of records selected from all the files that were 
processed) 

• If you process more than one file, the total number of files that were 
processed, and the total number of records selected and rejected 

Example 

$ ACCOUNTING MYFILE1.DAT,MYFILE2.DAT /TYPE=PRINT /S0RT=USER /OUTPUT=OUTFILE 

%ACC-I-INPUT, SYS$SYSROOT:[SYSMGRJMYFILE1.DAT;7, 297 selected, 16460 rejected 
%ACC-I-INPUT, SYS$SYSROOT:[SYSMGRJMYFILE2.DAT;13,302 selected, 16388 rejected 
%ACC-I-MERGE, 599 records to be merged 
%ACC-I-TOTAL, 599 selected, 32848 rejected, 2 input files 

This example processes two accounting files. It writes a brief report of all the 
records for print jobs, sorted in user name order, to an output file and displays 
informational messages that tell you which files were processed and how many 
records were selected and rejected. 


/NODE 

Selects or rejects records for DECnet for OpenVMS requests made by the specified 
nodes. 

Format 


/NODE=([-]node_name[,...]) 


Description 

The /NODE qualifier uses the value of the remote node name field to select 
records for processing. This field is present in all records except file backward 
link and file forward link records. For records that contain information about 
DECnet for OpenVMS requests, it contains the name of the node that made the 
request. 

The /NODE qualifier selects only records that have the specified values in the 
remote node name field. If you precede the values with a minus sign, it selects all 
records except those with the specified values. 


2-15 









ACCOUNTING 

/NODE 


Do not include the double colon (::) after the name of the node. 

See also the /ADDRESS and /REMOTEJD qualifiers, which select or reject 
records for DECnet for OpenVMS requests made by specified node addresses and 
remote IDs respectively. 

Examples 


1. $ ACCOUNTING /NODE=HQ291 /FULL 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a full report of all records for DECnet for OpenVMS requests made 
by the node HQ291. 


2. $ ACCOUNTING /NODE=(-HQ222,HQ223) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records except those for DECnet for OpenVMS 
requests made by the nodes HQ222 or HQ223. 


/OUTPUT 

Specifies the output file. 

Requires read and write access to the directory in which the output file is created. 

Format 

/OUTPUT[=filespec] 


Description 

The /OUTPUT qualifier creates the specified output file and writes the report or 
copies the selected records to that file. 

If you omit the /OUTPUT qualifier, or you use the /OUTPUT qualifier and omit 
the file specification, the report or selected records are output to the current 
SYS$OUTPUT device. 

If the file specification does not include the device or directory name, your current 
default device or directory is used. If you omit the file name, the file name of the 
first input file is used (the first file listed in the parameter to the ACCOUNTING 
command). If you omit the file type, the default file type is .LIS if you are 
producing reports, and .DAT if you are copying records. 

Examples 

1. $ ACCOUNTING MYFILE1.DAT,MYFILE2.DAT /S0RT=USER /BINARY /OUTPUT=.NEW 

This example creates the output file MYFILE1.NEW in the default directory. 
It processes two accounting files, MYFILE1.DAT and MYFILE2.DAT, sorting 
their records in user name order, then copies these records to the new output 
file. 
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2. $ ACCOUNTING MYFILE1.NEW /FULL /OUTPUT=MYDISK:[ACCOUNTING]STAT 

This example creates the output file MYDISK:[ACCOUNTING]STAT.LIS, and 
writes a full report of all the records in MYFILE1.NEW to the new output 
file. 


/OWNER 

Selects or rejects records for subprocesses created by the specified processes. 

Format 

/OWNER=([-]owner_pid[,...]) 

Description 

The /OWNER qualifier uses the value of the process owner field to select records 
for processing. This field is present in all records except file backward link 
and file forward link records. For a subprocess, this field contains the process 
identification (PID) of the process that created it. 

The /OWNER qualifier selects only records that have the specified values in the 
process owner field. If you precede the values with a minus sign, it selects all 
records except those with the specified values. 

See also the /IDENT qualifier, which selects or rejects records for specified 
processes. 

Example 


$ ACCOUNTING /OWNER=(25634,045A6B) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a brief report of all records for subprocesses created by processes with a PID of 
25634 or 045A6B. 


/PRIORITY 

Selects or rejects records for the specified priority. 

Format 

/PRIORITY=([-]priority[,...]) 

Description 

The /PRIORITY qualifier uses the value of the priority field to select records 
for processing. This field is present in all records except file backward link and 
file forward link records. For print and batch job records, this field contains the 
priority of the job in the print or batch queue. For other records, it contains the 
base process priority. 

The /PRIORITY qualifier selects only records that have the specified values in the 
priority field. If you precede the values with a minus sign, it selects all records 
except those with the specified values. 
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Example 

$ ACCOUNTING /PRI0RITY=3 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a brief report of all records for processes with a base priority of 3 and for print 
and batch jobs with a queue priority of 3. 


/PROCESS 


Selects or rejects records for the specified types of process. 


Format 

/PROCESS=([-]process_type[,...]) 


Keyword 


process_type[,...] 

Specifies which types of process you want to select or reject. This table shows the 
keywords available. 


Keyword 

Type of Process 

BATCH 

Batch process 

DETACHED 

Detached process 

INTERACTIVE 

Interactive process 

NETWORK 

Network process 

SUBPROCESS 

Subprocess of any of the other process types 


Description 

The /PROCESS qualifier uses the value of the process type field to select records 
for processing. This field is present only in records of type IMAGE and type 
PROCESS. For records of type IMAGE, this field contains the type of the process 
in which the image was executed. 

The /PROCESS qualifier selects only records that match the specified types of 
process. If you precede the list with a minus sign, it selects all records except 
those for the specified types of process. 

See also the /TYPE qualifier, which selects or rejects specified types of record. 

Example 

$ ACCOUNTING /TYPE=IMAGE /PROCESS=INTERACTIVE /FULL 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a full report of the resources used by images running in interactive processes. 
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/QUEUE 


Format 


Selects or rejects records for print or batch jobs executed by the specified queues. 


/QUEUE=([-]queue_name[,...]) 


Description 

The /QUEUE qualifier uses the value of the queue name field to select records for 
processing. This field is present in all records except file backward link and file 
forward link records. For records that contain information about print or batch 
jobs, it contains the name of the queue that executed the job. 

The /QUEUE qualifier selects only records that have the specified values in the 
queue name field. If you precede the values with a minus sign, it selects all 
records except those with the specified values. 

See also the /JOB and /ENTRY qualifiers, which select or reject records for print 
and batch jobs with specified job names and queue entry numbers respectively. 

Example 


$ ACCOUNTING /QUEUE=SYS$MYNODE_BATCH 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a brief report of all records for jobs executed by the SYS$MYNODE_BATCH 
queue. 


/REJECTED 


Copies the rejected records to a new file. 

Requires read and write access to the directory in which the specified file is 
created. 


Format 


/REJECTED=filespec 

Description 

The /REJECTED qualifier creates the specified file, then copies the records 
that do not match your selection criteria to this file in binary format. Use the 
Accounting utility to process this file later. 

If the file specification does not include the device or directory name, your current 
default device or directory is used. If you omit the file name, the file name of the 
first input file is used (the first file listed in the parameter to the ACCOUNTING 
command). If you omit the file type, REJ is used. 
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Example 


$ ACCOUNTING /TYPE=PRINT /BINARY /OUTPUT=PRINT_INFO.DAT - 
_$ /REJECTED=NOT_PRINT_INFO.DAT 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It creates 
two files, PRINT_INFO.DAT and NOT_PRINT_INFO.DAT, in the default 
directory. It copies print job records to PRINT_INFO.DAT and all other records to 
NOT_PRINT_INFO.DAT. 


/REMOTEJD 

Selects or rejects records for DECnet for OpenVMS requests made by the specified 
remote IDs. 

Format 

/REMOTE_ID=([-]remote_id[,...]) 

Description 

The /REMOTEJD qualifier uses the value of the remote ID field to select records 
for processing. This field is present in all records except file backward link and 
file forward link records. For records that contain information about DECnet for 
OpenVMS requests, this field contains a string that identifies the user who made 
the request. If the remote process was on an OpenVMS node, this is the user 
name of the user at the remote node. 

The /REMOTEJD qualifier selects only records that have the specified values in 
the remote ID field. If you precede the values with a minus sign, it selects all 
records except those with the specified values. 

See also the /NODE and /ADDRESS qualifiers, which select or reject records 
for DECnet for OpenVMS requests made by nodes with specified names and 
addresses respectively. 

Example 

$ ACCOUNTING /NODE=HQ223 /REMOTEJD=SMITH /FULL 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a full report of all the records for DECnet for OpenVMS requests made by user 
SMITH at the node HQ223. 


/REPORT 

Specifies the resources that you want to summarize in a summary report. 

Format 

/REPORT[=(resource[,...])] 
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Keyword 

resource[,...] 

Specifies the resources that you want to summarize in the report. Table 2-4 
shows the keywords available. 


Table 2-4 Resources You Can Summarize in a Summary Report 


Keyword 

Description 

How Summarized 

BUFFERED IO ** 

Number of buffered I/Os 

Total 

DIRECT.IO ** 

Number of direct I/Os 

Total 

ELAPSED * ** 

Elapsed time 

Total 

EXECUTION ** 

Number of images run by the 
process 

Total 

FAULTS ** 

Number of hard and soft page 
faults 

Total 

GETS * 

Number of GETs from the file that 
was printed 

Total 

PAGE_FILE ** 

Page file usage 

Maximum 

PAGE_READS ** 

Number of hard page faults 

Total 

PAGES * 

Number of pages printed 

Total 

PROCESSOR ** 

Total CPU time used 

Total 

QIOS * 

Number of QIOs to the printer 

Total 

RECORDS 

Number of accounting file records 
processed 

Total 

VECTOR. 
PROCESSOR ** 

Vector CPU time used (see the 
description of the /FULL qualifier 
for further details) 

Total 

VOLUMES ** 

Number of volumes mounted 

Total 

WORKING.SET ** 

Working set size 

Maximum 


* Present in records of type PRINT 

** Present in records of type IMAGE, LOGFAIL, PROCESS, and SYSINIT 


The RECORDS keyword is the default if you omit either the keywords or the 
/REPORT qualifier. It gives the total number of records for each summary key 
value. 

Description 

The /REPORT qualifier specifies the resources that you want to summarize in a 
summary report. The resources are summarized, either as totals or maximum 
values, for each summary key value specified by the /SUMMARY qualifier. 

When a record is processed that does not contain the specified resource field, 
a default value of 0 is used. For example, if you use the PAGES keyword to’ 
summarize the total pages printed, the value of 0 is used for each record that is 
not of type PRINT. 
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Note that the resource usage data stored in records of type IMAGE is a subset of 
the data stored in records of type PROCESS. For example, the CPU time stored 
in a record of type PROCESS includes the CPU time used by the images executed 
by that process. To make sure that you do not count the same resource data twice 
when you are summarizing process resources by totals, use the /TYPE qualifier to 
exclude records of type IMAGE. 

You cannot use the /REPORT qualifier without the /SUMMARY qualifier. 

Examples 

1. $ ACCOUNTING /SUMMARY=IMAGE /REPORT=(RECORDS,PROCESSOR) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a summary report that shows for each image the number of times it 
was executed and the total CPU time consumed. 

2. $ ACCOUNTING /TYPE=-IMAGE /SUMMARY=USER /REPORT=EXECUTION 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a summary report that shows the total number of images executed 
by each user. Notice the use of the /TYPE qualifier to exclude records of type 
IMAGE to avoid double counting. 


/SINCE 


Selects all records time-stamped at or after the specified time. 


Format 

/SINCE[=time] 

Description 

All records in an accounting file are time-stamped with the time the record was 
logged in the file. 

The /SINCE qualifier selects only the records time-stamped at or after the 
specified time. You can specify an absolute time, delta time, or a combination of 
the two. If you omit the time, 00:00 hours on the current day is used. 

See also the /BEFORE qualifier, which selects records time-stamped before a 
specified time. 

Example 


$ ACCOUNTING /SINCE=5-JAN-1995 

This example produces a brief report of all records time-stamped at or after 
5-JAN-1995 in the file SYS$MANAGER:ACCOUNTNG.DAT. 
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/SORT 

Sorts the selected records. 

Format 

/SORT[=([-]sort_field[,...])] 

Keyword 


sort_field[,...] 

Specifies the sort key. 

This table shows the keywords available. You can specify up to ten sort fields. 


Keyword 

Sorts on This Field 

ACCOUNT 

Account 

ADDRESS 

Address of the node that made the DECnet for 

Open VMS request 

BUFFEREDJD 

Number of buffered I/Os 

DIRECT.IO 

Number of direct I/Os 

ELAPSED 

Elapsed time 

ENTRY 

Print or batch job queue entry number 

EXECUTION 

Number of images run by the process 

FAULTS 

Number of hard and soft page faults 

FINISHED 

Time record was logged in the accounting file 

GETS 

Number of GETs from the file that was printed 

IDENT 

Process identification (PID) 

IMAGE 

Image name (sorts only on file name portion of the 
image file specification) 

JOB 

Name of print or batch job 

NODE 

Name of the node that made the DECnet for 
OpenVMS request 

OWNER 

PID of parent process 

PAGE.FILE 

Peak page file usage 

PAGE.READS 

Number of hard page faults 

PAGES 

Number of pages printed 

PRIORITY 

Base process priority, or print or batch queue priority 

PROCESS 

TVpe of process 

PROCESSOR 

Total CPU time used 

QIOS 

Number of QIOs to the printer 

QUEUE 

Name of print or batch queue 

QUEUED 

Time print job was queued 

STARTED 

Start time 

STATUS 

Final exit status code 
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Keyword 

Sorts on This Field 

TERMINAL 

Terminal name 

TYPE 

Type of record 

UIC 

User identification code 

USER 

User name at local node 

VECTOR_PROCESSOR 

Vector CPU time (see the description of the /FULL 


qualifier for further details) 

VOLUMES 

Number of volumes mounted 

WORKING.SET 

Peak working set size 


For each keyword, see the description of the corresponding Accounting utility 
qualifier or Table 2-5 for details of the types of record in which the corresponding 
field is present. 


Description 

The /SORT qualifier merges the selected records from each input file (each file 
listed in the parameter to the ACCOUNTING command) and sorts them using 
the specified sort key. The records are sorted according to the value of the first 
sort field in the list, and when two or more records have the same value in this 
field, they are sorted by the value of the second sort field in the list, and so on. 

The records are sorted in ascending order of the sort field value. If the keyword 
is preceded by a minus sign, the records are sorted in descending order. 

When you use the /SORT qualifier, records are rejected if they do not contain the 
sort field. For example, /SORT=IMAGE rejects all records that are not of type 
IMAGE, because the image name field is only present in records of type IMAGE. 
Similarly, /SORT=PAGES rejects all records except those for print jobs. 

You cannot use the /SORT qualifier with the /SUMMARY qualifier. 

Examples 

1. $ ACCOUNTING /TYPE=PRINT /SORT=USER 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all the records for print jobs and displays them in 
user name order. 

The following is an example of the report that is produced: 


Date / Time 


Type Subtype 

14-JAN-1995 

09:53:05 

PRINT 

13-JAN-1995 

13:36:04 

PRINT 

13-JAN-1995 

12:42:37 

PRINT 

13-JAN-1995 

14:43:56 

PRINT 

14-JAN-1995 

19:39:01 

PRINT 

14-JAN-1995 

20:09:03 

PRINT 

14-JAN-1995 

20:34:45 

PRINT 

14-JAN-1995 

11:23:34 

PRINT 

14-JAN-1995 

16:43:16 

PRINT 

14-JAN-1995 

09:30:21 

PRINT 


Username 

ID Source 

Status 

BROWN 


20A00193 

00040001 

BROWN 


20A00442 

00000001 

BROWN 


20A00442 

00000001 

DECNET. 

_MAIL 

20A00456 

00000001 

DECNET_ 

_MAIL 

20A00265 

00000001 

DECNET. 

_MAIL 

20A00127 

00000001 

DECNET. 

_MAIL 

20A00127 

00000001 

FISH 


20A0032E 

00040001 

JONES 


20A00070 

00040001 

SMITH 


20A00530 

00040001 


2-24 









ACCOUNTING 

/SORT 


2. $ ACCOUNTING MYFILE1.DAT,MYFILE2.DAT /SORT=IMAGE - 

_$ /FULL /REJECTED=NON_IMAGE.DAT 

This example processes two files, MYFILE1.DAT and MYFILE2.DAT, to 
produce a full report of records of type IMAGE, sorted in image name order. 
It creates the file NON_IMAGE.DAT, and copies all records except those of 
type IMAGE to that file. Notice that no selection qualifiers are used, and so 
all records are selected for processing. When the records are sorted, records 
that do not contain an image name are rejected. 


/STATUS 


Selects or rejects records with the specified final exit status codes. 

Format 

/STATUS=([-]status_code[,...]) 

Description 

The /STATUS qualifier uses the value of the final status code field to select 
records for processing. This field is present in all records except records of type 
USER, file backward link records, and file forward link records. 

The /STATUS qualifier selects only records that have the specified values in the 
final status code field. If you precede the values with a minus sign, it selects all 
records except those with the specified values. 

See the description of the /BRIEF qualifier for details of how to convert a final 
exit status code to the equivalent message text. 

Example 

$ ACCOUNTING /STATUS=10D38064 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a brief report of all records with a final exit status code of 10D38064. 


/SUMMARY 


Format 


Produces a summary report of the selected records. 

/SUMMARY[=(summary_item[,...])] 


Keyword 

summary_item[,...] 

Specifies the summary key. The following table lists keywords. 
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Keyword 

Description 

ACCOUNT 

Account 

DATE 

Date 

DAY 

Day of month (1-31) 

HOUR 

Hour of day (0-23) 

IMAGE 

Image name (file name portion of image file specification) 

JOB 

Name of print or batch job 

MONTH 

Month of year (1-12) 

NODE 

Name of the node that issued the DECnet for OpenVMS 
request 

PROCESS 

Process type 

QUEUE 

Print or batch job queue name 

TERMINAL 

Terminal name 

TYPE 

Record type 

UIC 

User identification code 

USER 

User name 

WEEKDAY 

Day of week (0=Sunday, l=Monday, and so on) 

YEAR 

Year 


If you omit these keywords, the user name is used as the summary key. 


Description 

The /SUMMARY qualifier produces a summary report of the selected records. 

The report is directed to the current SYS$OUTPUT device, unless you use the 
/OUTPUT qualifier to write it to a file. 

Summary reports give statistical summaries of the resources specified by 
the /REPORT qualifier for each value of the summary key specified by the 
/SUMMARY qualifier. If you omit the /REPORT qualifier, the summary report 
gives the total number of records processed for each summary key value. 

The first line of the summary report shows the time span of the data processed 
(when the first and last records processed were logged in the input files), with a 
title in the middle. You can use the /TITLE qualifier to specify your own title. 

The next few lines of the report are column headings. There is one column for 
each summaryjtem, then one column for each resource specified by the /REPORT 
qualifier. The columns are laid out in the same left-to-right sequence as the 
equivalent keywords in the /SUMMARY and /REPORT qualifiers. 

The rest of the report uses one line for each summary key value. It gives a 
summary of the resources associated with that summary key value. The data is 
sorted in ascending order of the summary key value. 

See also the /BINARY qualifier, which copies the selected records to a file, and the 
/BRIEF and /FULL qualifiers, which produce brief and full reports of the selected 
records. 

You cannot use the /SUMMARY qualifier with the /BINARY, /BRIEF, or /FULL 
qualifiers. 
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Examples 


/TERMINAL 


Format 


1. $ ACCOUNTING /TYPE=PRINT /SUMMARY=USER /REPORT=(PAGES,RECORDS) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
processes all the print job records and produces a summary report that shows, 
for each user, the total number of pages printed and the number of records 
that were added together to produce this total. This is an example of the 
report that is produced: 


From: 12-JAN-1995 15:55 VMS Accounting Report To: 15-JAN-1995 15:17 


2 . 


Username 

Pages Total 


Printed Records 

BROWN 

115 

2 

CROW 

3 

1 

CUTHBERT 

20 

4 

FOSTER 

46 

1 

SMITH 

50 

3 

WHITE 

50 

7 

$ ACCOUNTING 

/SUMMARY=IMAGE 

/REP0RT=(PROCESSOR,RECORDS) 

This example processes the file SYS$MANAGER:ACCOUNTNG.: 

produces a summary report that shows the total CPU time used 

image. This 

is an example of the report that is produced: 

From: 12-JAN- 

-1995 15:55 VMS Accounting Report To: 15-JAN-1995 

Image name 

Processor 

Total 


Time 

Records 


0 00:09:09.83 

51 

ACC 

0 00:01:36.72 

99 

AUTHORIZE 

0 00:00:04.17 

8 

CDU 

0 00:00:33.25 

21 

COPY 

0 00:00:05.97 

30 

DELETE 

0 00:00:02.79 

12 

DIRECTORY 

0 00:00:09.67 

38 

DUMP 

0 00:00:04.51 

3 

EDT 

0 00:00:05.85 

7 

LOGINOUT 

0 00:04:03.48 

75 

NETSERVER 

0 00:00:00.63 

23 

SHOW 

0 00:00:04.80 

22 


Selects or rejects records for interactive sessions at the specified terminals. 


/ r TERMINAL=([-]terminal_name[,...]) 
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Description 

The /TERMINAL qualifier uses the value of the terminal name field to select 
records for processing. This field is present in all records except file backward 
link and file forward link records. For records that contain information about 
interactive sessions, this field contains the name of the terminal associated with 
the session. 

The /TERMINAL qualifier selects only records that have the specified values in 
the terminal name field. If you precede the values with a minus sign, it selects 
all records except those with the specified values. 

Give the terminal name as the standard device name and include the colon (:). 

Example 


$ ACCOUNTING /TERMINAL=TTB3: 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a brief report of all records for interactive sessions at the terminal TTB3. 


/TITLE 


Specifies the title shown on the first line of a summary report. 

Format 

/TITLE=title 

Description 

The /TITLE qualifier specifies the title shown in the center of the first line of 
summary reports. The title is truncated if it is too long. For reports displayed on 
your screen, the title is truncated if it is longer than (W-56) characters, where W 
is the width (in characters) of your screen. 

Example 

$ ACCOUNTING /SUMMARY=IMAGE /TITLE="June Accounting Report" 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a summary report that shows the number of times each image was executed. The 
title “June Accounting Report” appears at the top of the report. 


/TYPE 


Format 


Selects or rejects the specified types of record. 


/TYPE=([-]record_type[,...]) 
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Keyword 

record_type[,...] 

Specifies the types of record that you want to select or reject. Table 2-5 shows 
the keywords available. 


Table 2-5 Types of Record in an Accounting File 


Keyword 

Type of 
Record 

Description of Record 

FILE 

FILE.BL 

File backward link. This is the first record in 
the accounting file. It is logged when the file is 
created, and contains the name of the previous 
accounting file. 


FILE.FL 

File forward link. This is the last record in the 
file. It is logged when the file is closed, and 
contains the name of the next accounting file. 

IMAGE 

IMAGE 

Image termination. It contains details of the 
resources used by the image. 

LOGFAIL 

LOGFAIL 

Failed attempt to log in. It contains details of the 
resources used by the login attempt. 

PRINT 

PRINT 

Print job termination. It contains details of the 
resources used by the print job. 

PROCESS 

PROCESS 

Process termination. It contains details of 
the resources used by the process. Note that 
this includes the resources used by the images 
executed by that process. 

SYSINIT 

SYSINIT 

System booted. It contains details of resources 
used to boot the system. 

UNKNOWN 


Record not recognized as one of the other types in 
this table. 

USER 

USER 

Record logged by a program calling the $SNDJBC 
system service to send an accounting message. 


Description 

All records in an accounting file contain a type field that contains the type of the 
record. 

The /TYPE qualifier selects the specified types of record. If you precede the list 
with a minus sign, it selects all records except those specified. 

See also the /PROCESS qualifier, which selects or rejects records for particular 
types of process. 

Examples 

1. $ ACCOUNTING /TYPE=PRINT 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records for print jobs. 
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2. $ ACCOUNTING /TYPE=-PRINT 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records except those for print jobs. 


/UIC 

Selects or rejects records for the specified UICs. 

Format 

/UIC=([-]uic[,...]) 

Description 

The /UIC qualifier uses the value of the UIC field to select records for processing. 
This field is present in all records except file backward link and file forward link 
records. It contains the value [SYSTEM] for login failure records where the user 
did not give a valid user name. 

The /UIC qualifier selects only records that have the specified values in the UIC 
field. If you precede the values with a minus sign, it selects all records except 
those with the specified values. 

You can specify the UIC in numeric or alphanumeric format, and can use the 
asterisk (*) wildcard character. 

Example 

$ ACCOUNTING /UIC=([360,*],[ADMIN,COTTON]) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces 
a brief report of all records for users in group number 360 or users whose UIC is 
[ADMIN,COTTON], 


/USER 


Selects or rejects records for the specified user names. 


Format 

/USER=([-]user name[,...]) 


Description 

The /USER qualifier uses the value of the user name field to select records for 
processing. This field is present in all records except file backward link and file 
forward link records. It contains the value <login> for login failure records where 
the user did not give a valid user name. 

The /USER qualifier selects only records that have the specified values in the 
user name field. If you precede the values with a minus sign, it selects all records 
except those with the specified values. 
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Examples 


1. $ ACCOUNTING /USER=SMITH 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all records for the user SMITH. 

2. $ ACCOUNTING /USER=(-SMITH,JONES) 

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It 
produces a brief report of all the records except for those of the users SMITH 
and JONES. 
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ANALYZE/DISK_STRUCTURE Description 

Use the Analyze/Disk_Structure utility (ANALYZE/DISK.STRUCTURE) on a 
regular basis to check disks for inconsistencies and errors, and to recover lost 
files. ANALYZE/DISK_STRUCTURE detects problems on On-Disk Structure 
(ODS) Level 1 or 2 Files—11 disks that were caused by hardware errors, system 
errors, and user errors. 

By using ANALYZE/DISK_STRUCTURE to identify and delete lost files and files 
marked for deletion, you can reclaim disk space. 

ANALYZE/DISK_STRUCTURE performs the verification of a volume or volume 
set in eight distinct stages. During these stages, ANALYZE/DISK_STRUCTURE 
collects information used in reporting errors or performing repairs. However, 
ANALYZE/DISK.STRUCTURE repairs volumes only when you specify the 
/REPAIR qualifier. For a complete description of each of the eight stages, and 
an annotated example of an ANALYZE/DISK_STRUCTURE session, refer to 
Appendix D. 

3.1 Error Reporting and Repair 

You can invoke the Analyze/Disk_Structure utility to operate in any of the 
following three modes: 

• Error reporting with no repairs 

• Error reporting with repairs 

• User-controlled selective repairs 

By default, ANALYZE/DISK_STRUCTURE reports errors, but does not make 
repairs. For example, use the following command to report all errors on device 
DBA1: 

$ ANALYZE/DISK_STRUCTURE DBA1: 

When you issue this command, ANALYZE/DISK_STRUCTURE runs through 
eight stages of data collection, then, by default, prints a list of all errors and lost 
files to your terminal. One type of problem that ANALYZE/DISK_STRUCTURE 
locates is an invalid directory backlink; a backlink is a pointer to the directory 
in which a file resides. If your disk has a file with an invalid directory backlink, 
ANALYZE/DISK.STRUCTURE displays the following message and the file 
specification to which the error applies: 

%VERIFY-I-BACKLINK, incorrect directory back link [SYSEXE]SYSBOOT.EXE;1 

To instruct ANALYZE/DISK_STRUCTURE to repair the errors that it detects, 
use the /REPAIR qualifier. For example, the following command reports and 
repairs all errors on the DBA1 device: 

$ ANALYZE/DISK_STRUCTURE DBA1:/REPAIR 

If you want to select which errors ANALYZE/DISK_STRUCTURE repairs, use 
both the /REPAIR and /CONFIRM qualifiers: 

$ ANALYZE/DISK_STRUCTURE DBA1:/REPAIR/CONFIRM 
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When you issue this command, ANALYZE/DISK_STRUCTURE displays a 
description of each error and prompts you for confirmation before making 
a repair. For example, the previous command might produce the following 
messages and prompts: 

%VERIFY-I-BACKLINK, incorrect directory back link [SYS0]SYSMAINT.DIR;1 
Repair this error? (Y or N): Y 

%VERIFY-I-BACKLINK, incorrect directory back link 
[SYSEXE]SYSBOOT.EXE;1] 

Repair this error? (Y or N): N 

Consider running ANALYZE/DISK_STRUCTURE twice for each volume. First, 
invoke the utility to report all errors. Evaluate the errors and decide on an 
appropriate action. Then invoke the utility again with the /REPAIR qualifier 
to repair all errors, or with the /REPAIR and /CONFIRM qualifiers to repair 
selected errors. 

For message descriptions, use the online Help Message (MSGHLP) utility or refer 
to the OpenVMS system messages documentation. 


3.1.1 Recovering Lost Files 

A lost file is a file that is not linked to a directory. Under normal circumstances, 
files do not become lost. However, files occasionally become lost because of disk 
corruption, hardware problems, or user error. For example, in cleaning up files 
and directories, you might inadvertently delete directories that still point to 
files. When you delete a directory file (a file wdth the file type .DIR) without first 
deleting its subordinate files, the files referred to by that directory become lost 
files. Though lost, these files remain on the disk and consume space. 

When you run ANALYZE/DISK.STRUCTURE specifying the /REPAIR qualifier, 
the utility places lost files in SYSLOST.DIR. 


For example, to report and repair all errors and lost files found on the device 
DDAO, issue the following command: 

$ ANALYZE/DISK_STRUCTURE/REPAIR/CONFIRM DDAO: 

If it discovers lost files on your disk, ANALYZE/DISK_STRUCTURE issues 
messages similar to those that follow: 


%VERIFY-W-LOSTHEADER, file (16,1,1) 
not found in a directory 
%VERIFY-W-LOSTHEADER, file (17,1,1) 
not found in a directory 
%VERIFY-W-LOSTHEADER, file (18,1,1) 
not found in a directory 
%VERIFY-W-LOSTHEADER, file (19,1,1) 
not found in a directory 
%VERIFY-W-LOSTHEADER, file (20,1,1) 
not found in a directory 
IVERIFY-W-LOSTHEADER, file (21,1,1) 
not found in a directory 
%VERIFY-W-LOSTHEADER, file (22,1,1) 
not found in a directory 
%VERIFY-W-LOSTHEADER, file (23,1,1) 
not found in a directory 
%VERIFY-W-LOSTHEADER, file (24,1,1) 
not found in a directory 


[]X.X;1 
I]Y.Y;1 
[ ] Z. Z; 1 
[]X.X;2 
11Y.Y;2 
[ ] Z.; 1 
[ 1 Z.; 2 

LOGIN.COM;163 
MANYACL.COM;! 


All lost files in this example are automatically moved to SYSLOST.DIR. 
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3.1.2 Erasing Old Home Blocks 

When you initialize a volume, the initialize operation might not erase old home 
blocks. These are blocks that were created by previous initialize operations. If a 
volume that has old home blocks is damaged, you may not be able to recover the 
volume without erasing the blocks. 

You can erase old home blocks manually by using the /HOMEBLOCKS qualifier 
on the ANALYZE/DISK_STRUCTURE command as follows: 

$ ANALYZE/DISK_STRUCTURE /REPAIR/HOMEBLOCKS 

Note that this operation can take up to 30 minutes to complete. 

3.1.3 ANALYZE/DISK_STRUCTURE Output 

By default, the Analyze/Disk_Structure utility directs all output to your terminal. 
If you prefer, you can use the /LIST qualifier to generate a file containing the 
following information for each file on the disk: 

• File identification (FID) 

• File name 

• Owner 

• Errors associated with the file 

To generate a disk usage accounting file, use the /USAGE qualifier. The first 
record of the file, called the identification record, contains a summary of disk 
and volume characteristics. The identification record is followed by a series of 
summary records; one summary record is created for each file on the disk. A 
summary record contains the owner, size, and name of the file. 

For more information on the disk usage accounting file, see Appendix E. 
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The Analyze/Disk_Structure utility checks the readability and validity of Files-11 
Structure Level 1 and Structure Level 2 disk volumes, and reports errors and 
inconsistencies. 

You can detect most classes of errors by invoking the utility once and using its 
defaults. 

Format 

ANALYZE/DISK_STRUCTURE device-name:[/qualifier] 

Parameter 

device-name 

Specifies the disk volume or volume set to be verified. If you specify a volume 
set, all volumes of the volume set must be mounted as Files—11 volumes. For 
information on the Mount utility, refer to the OpenVMS System Management 
Utilities Reference Manual: M-Z. 

Usage Summary 

Use the following command to invoke the utility: 

ANALYZE/DISK_STRUCTURE device-name: /qualifiers 

To terminate an ANALYZE/DISK_STRUCTURE session, press Ctrl/C or Ctrl/Y 
while the utility executes. You cannot resume a session by using the DCL 
command CONTINUE. 

By default, ANALYZE/DISK_STRUCTURE directs all output to your terminal. 
Use the /USAGE or /LIST qualifiers to direct output to a file. 

To repair a disk effectively, you must have read, write, and delete access to all 
files on the disk. To effectively scan a disk (/NOREPAIR), you must have read 
access to all files on the disk. 

For a complete explanation of file access, see the Security Guide. 

You can safely use ANALYZE/DISK_STRUCTURE on a disk that is concurrently 
being used for other file operations. If you specify /REPAIR, the utility locks 
the volume before performing any operations; this blocks volume modification. 
Because other users cannot create, delete, extend, or truncate files, repair 
operations are unimpeded and the volume is left in a consistent state. 

If you specify /NOREPAIR, the volume is not locked; the utility does not attempt 
to write to the disk. However, if users perform file operations while you run the 
utility, you may receive error messages that incorrectly indicate file damage. 

To avoid this problem, Digital recommends that you run ANALYZE/DISK_ 
STRUCTURE when the disk is in a quiescent state. 
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ANALYZE/DISK STRUCTURE 


ANALYZE/DISK_STRUCTURE Qualifiers 

This section describes and provides examples of each ANALYZE/DISK_ 
STRUCTURE qualifier. Table 3—1 summarizes the qualifiers. 


Table 3-1 ANALYZE/DISK STRUCTURE Qualifiers 


Qualifier 

Description 

/[NOICONFIRM 

Determines whether the Analyze/Disk_Structure 
utility prompts you to confirm each repair 

/HOMEBLOCKS 

Erases damaged home blocks on an initialized volume. 

/[NO]LIST[=filespec] 

Determines whether the Analyze/Disk_Structure 
utility produces a listing of the index file 

/[NO]OUTPUT[=filespec] 

Specifies the output file to which the Analyze/Disk_ 
Structure utility writes the disk structure errors 

/[NOIRE AD_CHECK 

Determines whether the Analyze/Disk_Structure 
utility performs a read check of all allocated blocks on 
the specified disk 

/RECORD_ATTRIBUTES 

Determines whether the Analyze/Disk_Structure 
utility repairs files containing erroneous settings in 
the record attributes section of their associated file 
attribute block (FAT) 

/[NOJREPAIR 

Determines whether the Analyze/Disk_Structure 
utility repairs errors that are detected in the file 
structure of the specified device 

/US AGE [=filespecl 

Specifies that a disk usage accounting file should be 
produced, in addition to the other specified functions of 
the Analyze/Disk_Structure utility 



/[NO]CONFIRM 

Determines whether the Analyze/Disk_Structure utility prompts you to confirm 
each repair. If you respond with Y or YES, the utility performs the repair. 
Otherwise, the repair is not performed. 

Format 

/[NO]CONFIRM 

Description 

You can only use the /CONFIRM qualifier with the /REPAIR qualifier. The 
default is /NOCONFIRM. 
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ANALYZE/DISK_STRUCTURE 

/[NOJCONFIRM 


Example 

$ ANALYZE/DISK_STRUCTURE DBAO:/REPAIR/CONFIRM 

%VERIFY-I-BACKLINK, incorrect directory back link [SYS0]SYSMAINT.DIR;1 
Repair this error? (Y or N): Y 

%VERIFY-I-BACKLINK, incorrect directory back link [SYSEXE]SYSB00T.EXE;1 
Repair this error? (Y or N): N 

The command in this example causes the Analyze/Disk_Structure utility to 
prompt you for confirmation before performing the indicated repair operation. 


/HOMEBLOCKS 

Erases home blocks from a volume whose home blocks were not deleted during 
previous initialization operations. 

Format 

/HOMEBLOCKS 

Description 

You can only use the /HOMEBLOCKS qualifier with the /REPAIR qualifier. The 
operation can take 30 minutes to complete. 

Example 

$ ANALYZE/DISK_STRUCTURE DBAO:/REPAIR/HOMEBLOCKS 

The command in this example causes the Analyze/Disk_Structure utility to erase 
home blocks on DBAO. 


/[NO]LIST[=filespec] 

Determines whether the Analyze/Disk_Structure utility produces a listing of the 
index file. 

Format 

/LIST[=filespec] 

/NOLIST 

Description 

If you specify /LIST, the utility produces a file that contains a listing of all 
file identifications (FIDs), file names, and file owners. If you omit the file 
specification, the default is SYS$OUTPUT. If you include a file specification 
without a file type, the default type is .LIS. You cannot use wildcard characters in 
the file specification. 

The default is /NOLIST. 
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ANALYZE/DISK_STRUCTURE 

/[NO]LIST[=filespec] 


Example 

$ MALYZE/DISK_STRUCTURE DLA2:/LIST=INDEX 
$ TYPE INDEX 

Listing of index file on DLA2: 

31-DEC-1988 20:54:42.22 


( 00000001 , 00001 , 001 ) 

( 00000002 , 00002 , 001 ) 

(00000003,00003,001) 

(00000004,00004,001) 

(00000005,00005,001) 


INDEXF.SYS;1 
( 1 , 1 ] 
BITMAP.SYS;1 
[ 1 , 1 ] 
BADBLK.SYS;1 
[ 1 , 1 ] 
000000.DIR;1 
[ 1 , 1 ] 
CORIMG.SYS;1 
[ 1 , 1 ] 


$ 

In this example, ANALYZE/DISK_STRUCTURE did not find errors on the device 
DLA2. Because the file INDEX was specified without a file type, the system 
assumes a default file type of .LIS. The subsequent TYPE command displays the 
contents of the file INDEX.LIS. 


/[NO]OUTPUT 

Specifies the output file to which the Analyze/Disk_Structure utility is to write 
the disk structure errors. 

Format 

/[NO]OUTPUT[=filespec] 

Description 

Specifies the output file for the disk structure errors. If you omit the /OUTPUT 
file specification, output is directed to SYS$OUTPUT. If/NOOUTPUT is specified, 
no disk structure errors are displayed. If the /CONFIRM qualifier is specified, 
output is forced to SYS$OUTPUT regardless of whether this qualifier is used. 


/[NO]READ_CHECK 

Determines whether the Analyze/Disk_Structure utility performs a read check 
of all allocated blocks on the specified disk. When the Analyze/Disk_Structure 
utility performs a read check, it reads the disk twice; this ensures that it reads 
the disk correctly. The default is /NOREAD_CHECK. 

Format 

/[NO]READ_CHECK 


3-9 















ANALYZE/DISK_STRUCTURE 

/[NO]READ_CHECK 

Example 


$ ANALYZE/DISK_STRUCTURE DMA1:/READ_CHECK 

The command in this example directs ANALYZE/DISK_STRUCTURE to perform 
a read check on all allocated blocks on the device DMA1. 


/RECORD_ATTRIBUTES 


Determines whether the Analyze/Disk_Structure utility repairs files containing 
erroneous settings in the record attributes section of their associated file attribute 
block (FAT). 

Format 


/RECORD_ATTRIBUTES 


Description 

The /RECORD_ATTRIBUTES qualifier may be used with the /REPAIR qualifier. 
If attribute repair is enabled during the repair phase, erroneous bits will be 
cleared from a file’s record attributes. This action may not correctly set a file’s 
record attributes as it is beyond the scope of this utility to determine their correct 
values. 

It is recommended that system managers do not perform an attribute repair; 
instead they should notify the owners of the files about the inconsistencies 
and have the owners reset the files’ attributes using the SET FILE/RECORD_ 
ATTRIBUTES=({record-attributes}) command. 


Example 

$ ANALYZE/DISK_SYS $ SYSDEVICE: 

%ANALDISK-I-BAD_RECATTR, file (2930,1,1) [USER]ATTRIBUTES.DAT;13 
file record format: Variable 
inconsistent file attributes: Bit 5 

%ANALDISK-I-BAD_RECATTR, file (2931,1,1) [USER]ATTRIBUTES.DAT;14 
file record format: Variable 

inconsistent file attributes: FORTRAN carriage control, Bit 5 
%ANALDISK-I-BAD_RECATTR, file (2932,1,1) [USER]ATTRIBUTES.DAT;15 
file record format: Variable 

inconsistent file attributes: Implied carriage control, Bit 5 
%ANALDISK-I-BAD_RECATTR, file (2933,1,1) [USER]ATTRIBUTES.DAT;16 
file record format: Variable 

inconsistent file attributes: Non-spanned, Bit 5 

%ANALDISK-I-BAD_RECATTR, file (2934,1,1) [USER]ATTRIBUTES.DAT;17 

file record format: Variable 

inconsistent file attributes: FORTRAN carriage control, 
Non-spanned, Bit 5 
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ANALYZE/DISK_STRUCTURE 

/[NO]REPAIR 


/[NOJREPAIR 


Determines whether the Analyze/Disk_Structure utility repairs errors that are 
detected in the file structure of the specified device. 


Format 

/[NOJREPAIR 

Description 

The Analyze/Disk_Structure utility does not perform any repair operation unless 
you specify the /REPAIR qualifier. The file structure is software write-locked 
during a repair operation. The default is /NOREPAIR. 

Example 


$ ANALYZE/DISKJSTRUCTURE DBA1:/REPAIR 

The command in this example causes ANALYZE/DISK_STRUCTURE to perform 
a repair on all errors found in the file structure of device DBA1. 


/USAGE[=filespec] 


Specifies that a disk usage accounting file should be produced, in addition to the 
other specified functions of the Analyze/Disk_Structure utility. 


Format 

/USAGE[=filespec] 

Description 

If all or part of the file specification is omitted, ANALYZE/DISK_STRUCTURE 
assumes a default file specification of USAGE.DAT. The file is placed in the 
current default directory. 

Example 


$ ANALYZE/DISK_STRUCTURE DBA1:/USAGE 
$ DIRECTORY USAGE 

Directory DISK$DEFAULT:[ACCOUNT] 

USAGE.DAT;1 

Total of 1 file. 

The first command in this example causes ANALYZE/DISK_STRUCTURE to 
produce a disk usage accounting file. Because a file specification was not provided 
in the command line, ANALYZE/DISK_STRUCTURE uses both the default 
file name and directory [ACCOUNTJUSAGE.DAT. The DIRECTORY command 
instructs the system to display all files with a file name of usage in the current 
directory. 
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ANALYZE/AUDIT Description 

The Audit Analysis utility (ANALYZE/AUDIT) is a system management tool that 
enables system managers or site security administrators to produce reports from 
security audit log files. 

The OpenVMS operating system automatically audits a limited number of 
events, such as changes to the authorization database and use of the SET AUDIT 
command. Depending on your site’s requirements, you may want to enable other 
forms of reporting. However, collecting security audit messages is useful only if 
you develop and implement a procedure to periodically review the audit log file 
for suspicious activity. Use ANALYZE/AUDIT to examine the data in security 
audit log files or security archive files. 

The ANALYZE/AUDIT command’s different qualifiers allow you to specify the 
type of information the utility extracts from the security audit log file. The utility 
can produce an audit report in a variety of formats and direct a report to a file or 
a terminal. 

A description of the format of the auditing messages written to the security 
auditing file appears in Appendix F. 

In a mixed-version cluster, an audit log file contains entries from systems 
running different versions of the operating system. To analyze the log file, you 
must invoke the Audit Analysis utility (ANALYZE/AUDIT) from a node running 
Version 6.1 or later. 

For information on how to generate audit messages records and how to use 
ANALYZE/AUDIT, see the OpenVMS Guide to System Security. 


4-3 







ANALYZE/AUDIT Usage Summary 


The Audit Analysis utility (ANALYZE/AUDIT) processes event messages in 
security audit log files to produce reports of security-related events on the system. 

Format 

ANALYZE/AUDIT [file-spec[,...]] 

Parameter 

file-spec[,...] 

Specifies one or more security audit log files as input to ANALYZE/AUDIT. If you 
specify more than one file name, separate the names with commas. 

If you omit the file-spec parameter, the utility searches for the default audit log 
file SECURITY.AUDIT$JOURNAL. 

The default audit log file is created in the SYS$COMMON:[SYSMGR] directory. 
To use the file, specify SYS$MANAGER on the ANALYZE/AUDIT command line. 
If you do not specify a directory, the utility searches for the file in the current 
directory. 

You can include wildcard characters, such as the asterisk (*) or percent sign (%), 
in the file specification. 

The audit log file can be located in any directory. To display the current location, 
use the DCL command SHOW AUDIT/ALL. 

Usage Summary 

Use the DCL command ANALYZE/AUDIT to analyze security audit log files or 
security archive files. An ANALYZE/AUDIT command line can specify the name 
of one or more log files, as follows: 

ANALYZE/AUDIT [file-spec,...] 

You can also use the ANALYZE/AUDIT command to extract security event 
messages from security archive files or from binary files (created with previous 
ANALYZE/AUDIT commands). 

Each ANALYZE/AUDIT request runs until the log file is completely processed. 
You can interrupt the processing to modify the display or to change position in 
the report if you activate command mode by pressing Ctrl/C. To terminate an 
ANALYZE/AUDIT request before completion, press Ctrl/Z. 

You can direct ANALYZE/AUDIT output to any supported terminal device or 
to a disk or tape file by specifying the file specification as an argument to the 
/OUTPUT qualifier. By default, the output is directed to SYS$OUTPUT. 

Use of ANALYZE/AUDIT requires no special privileges other than access to the 
files specified in the command line. 










ANALYZE/AUDIT 


ANALYZE/AUDIT Qualifiers 

This section describes ANALYZE/AUDIT and provides examples of each qualifier. 
Table 4-1 summarizes the ANALYZE/AUDIT qualifiers. 


Table 4-1 ANALYZE/AUDIT Qualifiers 


Qualifier 

Description 

/BEFORE 

Controls whether records dated earlier than the specified time 
are selected 

/BINARY 

Controls whether output is a binary file 

/BRIEF 

Controls whether a brief, single-line record format is used in 
ASCII displays 

/EVENT_TYPE 

Selects the classes of events to be extracted from the security 
log file 

/FULL 

Controls whether a full format is used in ASCII displays 

/IGNORE 

Excludes records from the report that match the specified 
criteria 

/INTERACTIVE 

Controls whether interactive command mode is enabled when 
the Audit Analysis utility is invoked 

/OUTPUT 

Specifies where to direct output from the Audit Analysis utility 

/PAUSE 

Specifies the length of time each record is displayed in a full 
format display 

/SELECT 

Specifies the criteria for selecting records 

/SINCE 

Indicates that the utility must operate on records dated with 
the specified time or after the specified time 

/SUMMARY 

Specifies that a summary of the selected records be produced 
after all records are processed 


/BEFORE 

Controls whether records dated earlier than the specified time are selected. 

Format 

/BEFORE[=time] 

/NOBEFORE 

Keyword 

time 

Specifies the time used to select records. Records dated earlier than the specified 
time are selected. You can specify an absolute time, delta time, or a combination 
of the two. Observe the syntax rules for date and time described in the OpenVMS 
User's Manual. 
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ANALYZE/AUDIT 

/BEFORE 


Description 

Examples 


/BINARY 

Format 

Keywords 

Description 

Example 


By default, all records in the security audit log file may be examined. You must 
specify /BEFORE to exclude records created after a specific point in time. 


1. $ ANALYZE/AUDIT /BEFORE=25-NOV-1994 - 
_$ SYS$MANAGER: SECURITY. AUDIT$JOURNAL 

The command in this example selects all records dated earlier than November 
25, 1994. 

2. $ ANALYZE/AUDIT /BEF0RE=14:00/SINCE=12:00 - 
_$ SYS$MANAGER: SECURITY. AUDIT$JOURNAL 

The command in this example selects all records generated between noon and 
2 P.M. today. 


Controls whether output is a binary file. 


/BINARY 

/NOBINARY 

None. 


When /BINARY is used, the output file specified by using the /OUTPUT qualifier 
contains image copies of the selected input records. If you specify /NOBINARY or 
omit the qualifier, the output file contains ASCII records. 

By default, if you specify /BINARY and do not include the /OUTPUT qualifier, an 
output file named AUDIT.AUDIT$JOURNAL is created. 

The /BINARY, /BRIEF, and /FULL qualifiers cannot be used in combination. 


$ ANALYZE/AUDIT /BINARY/SINCE=TODAY/OUTPUT=25DEC94.AUDIT - 
_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example selects all audit records generated today and 
writes the records in binary format to 25DEC94.AUDIT. 
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ANALYZE/AUDIT 

/BRIEF 


/BRIEF 


Controls whether a brief, single-line record format is used in ASCII displays. 


Format 

/BRIEF (default) 

Keywords 

None. 


Description 

By default, records are displayed in the brief format. You must specify /FULL to 
have the full contents of each selected audit event record displayed. 

The /BINARY, /BRIEF, and /FULL qualifiers cannot be used in combination. 

Example 

$ ANALYZE/AUDIT /OUTPUT=AUDIT.LIS - 
_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example produces an ASCII file in brief format by default. 
The report is written to the AUDIT.LIS file. 


/EVENTTYPE 

Selects the classes of events to be extracted from the security log file. If you omit 
the qualifier or specify the ALL keyword, the utility includes all enabled event 
classes in the report. 

Format 

/EVENT_TYPE=(event-type[,...]) 

Keyword 

event type[,...] 

Specifies the classes of events 
following event types: 

[NOJACCESS 
[NOJALL 
[NOJAUDIT 
[NOJAUTHORIZATION 


[NOJBREAKIN 


used to select records. You can specify any of the 

Access to an object, such as a file 
All event types 

Use of the SET AUDIT command 

Change to the authorization database 
(SYSUAF.DAT, RIGHTSLIST.DAT, 
NETPROXY.DAT, or NET$PROXY.DAT) 

Break-in detection 
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ANALYZE/AUDIT 

/EVENTTYPE 


[NOJCONNECTION 


[NOICREATE 

[NOJDEACCESS 

[NO]DELETE 

[NOJINSTALL 

[NOJLOGFAIL 

[NOJLOGIN 

[NOJLOGOUT 

[NOJMOUNT 

[NO]NCP 

[NOJNETPROXY 

[NOJPRIVILEGE 

[NOJPROCESS 


[N 0]RIGHTSDB 
[NOJSYSGEN 


[NO]SYSUAF 

[NO]TIME 


Establishment of a network connection through 
the OpenVMS System Management utility 
(SYSMAN), DECwindows, or interprocess 
communication (IPC) software or DECnet Phase 
IV (VAX only) 

Creation of an object 
Completion of access to an object 
Deletion of an object 

Modification of the known file list with the Install 
utility (INSTALL) 

Unsuccessful login attempt 
Successful login 
Successful logout 

Execution of DCL commands MOUNT or 
DISMOUNT 

Modification of the DECnet network 
configuration databases 

Modification of the network proxy authorization 
file (NETPROXY.DAT or NET$PROXY.DAT) 

Privilege auditing 

Use of one or more of the process control system 
services: $CREPRC, $DELPRC, $SCHDWK, 
$CANWAK, $WAKE, $SUSPND, $RESUME, 
$GRANTID, $REVOKID, $GETJPI, $FORCEX, 
$SETPRI 

Modification of the rights database 
(RIGHTSLIST.DAT) 

Modification of system parameters through 
the System Generation utility (SYSGEN) or 
AUTOGEN 

Modification of the system user authorization file 
(SYSUAF.DAT) 

Change in system or cluster time 


Specifying the negated form of an event class (for example, NOLOGFAIL) 
excludes the specified event class from the audit report. 


Examples 

1. $ ANALYZE/AUDIT/EVENT_TYPE=LOGFAIL - 
_$ SYS$MANAGER: SECURITY. AUDIT$JOURNAL 

The command in this example extracts all records of unsuccessful login 
attempts, which match the LOGFAIL class, and compiles a brief report. 

2. $ ANALYZE/AUDIT/EVENT_TYPE=(NOLOGIN,NOLOGOUT) - 
_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example builds a report in brief format of all audit 
records except those in the LOGIN and LOGOUT event classes. 
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/FULL 


/FULL 


Controls whether a full format is used in ASCII displays. If you specify /NOFULL 
or omit the qualifier, records are displayed in the brief format. 

Format 

/FULL 

/NOFULL (default) 

Keywords 

None. 

Description 

By default, records are displayed in the brief format. You must specify /FULL (or 
enter command mode by pressing Ctrl/C) to have the full contents of each selected 
record displayed. 

The /BINARY, /BRIEF, and /FULL qualifiers cannot be used in combination. 

Example 

$ ANALYZE/AUDIT /FULL - 
_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example displays the full contents of each selected record. 


/IGNORE 

Excludes records from the report that match the specified criteria. 

Format 

/IGNORE=criteria[,...] 

Keyword 

criteria[,...] 

Specifies that all records are selected except those matching any of the specified 
exclusion criteria. See the /SELECT qualifier description for a list of the possible 
criteria to use with the /IGNORE qualifier. 

Description 

Use the /IGNORE qualifier to exclude specific groups of audit records from the 
audit report. When more than one keyword from the list of possible exclusion 
criteria are specified, records that meet any of these criteria are excluded by 
default. 
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ANALYZE/AUDIT 

/IGNORE 


Example 

$ ANALYZE/AUDIT/IGNORE=(SYSTEM=NAME=WIPER,USERNME=MILANT) - 

_$ SYS$MANAGER:SECURITY.AUDIT?JOURNAL 

The command in this example excludes from the audit analysis report all records 
in the audit log file generated from node WIPER or from user MILANT (on any 
node). 


/INTERACTIVE 


Controls whether interactive command mode is enabled when the Audit Analysis 
utility is invoked. 


Format 

/INTERACTIVE (default) 

/NOINTERACTIVE 

Keywords 

None. 

Description 

Interactive command mode, which is enabled by default, allows you to interrupt 
the audit report being displayed on the terminal and to enter commands either 
to modify the criteria used to select records for the report or to reposition the 
display. 

To interrupt a full or brief audit report, press Ctrl/C and enter commands at the 
COMMAND> prompt. Once in command mode, the utility displays the current 
record in full format. Note that the record might not match the selection or 
exclusion criteria specified in the previous ANALYZE/AUDIT command. 

The NEXT RECORD command is the default when you enter command mode. 
When ANALYZE/AUDIT reaches the end of the log file, it prompts for the next 
command. To verify the current log file name and your position within the file, 
press Ctrl/T. 

Enter the CONTINUE command to leave interactive command mode and to 
resume display of the audit report. Enter the EXIT command to terminate the 
session. See the ANALYZE/AUDIT Commands section for a description of each 
interactive command. 

To disable interactive mode, specify /NOINTERACTTVE. In this mode, the utility 
displays audit records one at a time and prompts you to advance the display by 
pressing the Return key. 
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/INTERACTIVE 


Examples 

1. $ ANALYZE/AUDIT/FULL - 

_$ SYS$MANAGER:SECURITY.AUDIT?JOURNAL 

The command in this example produces a full format display of the selected 
records. New records are displayed every 3 seconds. (See the /PAUSE 
qualifier description to find how to modify the duration of each record display.) 
Press Ctrl/C to interrupt the display and to enter interactive commands. 

2. $ ANALYZE/AUDIT/FULL/NOINTERACTIVE - 
_$ SYS$MANAGER:SECURITY.AUDIT?JOURNAL 

The command in this example invokes the utility in noninteractive mode. It 
displays the first record selected and prompts you to press the Return key to 
display each additional selected record. Control returns to the DCL command 
level when all selected records have been displayed. 


/OUTPUT 

Specifies where to direct output from the Audit Analysis utility (ANALYZE 
/AUDIT). If you omit the qualifier, the report is sent to SYS$OUTPUT. 

Format 

/OUTPUT[=file-spec] 

/NOOUTPUT 

Keyword 

file-spec[,...] 

Specifies the name of the file that is to contain the selected records. If you 
omit the device and directory specification, the utility uses the current device 
and directory specification. If you omit the file name and type, the default 
file name AUDIT.LIS is used. If the output is binary (/BINARY) and you 
omit the /OUTPUT qualifier, the binary information is written to the file 
AUDIT.AUDIT$JOURNAL. 

Example 


? ANALYZE/AUDIT /BINARY/OUTPUT=BIN122588.DAT - 
_? SYS?MANAGER:SECURITY.AUDIT?JOURNAL 

The command in this example selects audit records from the system audit log file 
and writes them to the binary file BIN122588.DAT. 
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ANALYZE/AUDIT 

/PAUSE 


/PAUSE 


Specifies the length of time each record is displayed in a full-format display. 

Format 

/PAUSE=seconds 

Keyword 

seconds 

Specifies the duration (in seconds) of the full-screen display. A value of 0 specifies 
that the system should not pause before displaying the next record. By default, 
the utility displays a record for 3 seconds. 

Description 

The /PAUSE qualifier can be used only with full-format (/FULL) displays to 
specify the length of time each record is displayed. By default, each record is 
displayed for a period of 3 seconds. A value of 0 results in a continuous display of 
audit records. 

Example 


$ ANALYZE/AUDIT /FULL/PAUSE=1 - 
_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example displays a selected record in full format every 
second. You can interrupt the display and enter interactive commands at any 
time by pressing Ctrl/C. (See the ANALYZE/AUDIT Commands section for more 
information.) 


/SELECT 

Specifies the criteria for selecting records from the audit log file. See the 
OpenVMS Guide to System Security for a description of how to generate audit 
records. 

Format 

/SELECT=criteria[,...] 

/NOSELECT 

Keyword 

criteria[,...] 

Specifies the criteria for selecting records. For each specified criterion, ANALYZE 
/AUDIT has two selection requirements: 

• The packet corresponding to the criterion must be present in the record. 

• One of the specified values must match the value in that packet. 
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ANALYZE/AUDIT 

/SELECT 


For example, if you specify 

the criteria (USER=(PUTNAM,WU),SYSTEM=DBASE), ANALYZE/AUDIT 
selects an event record containing the SYSTEM=DBASE packet and a USER 
packet with either the PUTNAM value or the WU value. 

If you omit the /SELECT qualifier, all event records selected through the 

/EVENT_TYPE qualifier are extracted from the audit log file and included in the 
report. 

You can specify any of the following criteria: 

ACCESS=(type,...) 

Specifies the type of object access upon which the selection is based. Access is 
object-specific and includes the following types: 


Associate 

Execute 

Read 

Control 

Lock 

Submit 

Create 

Logical 

Use 

Delete 

Manage 

Write 


Physical 



The OpenVMS Guide to System Security describes each of these types. 

ACCOUNT=(name,...) 

Specifies the account name upon which selection is based. You can use wildcards, 
such as an asterisk (*) or percent sign (%), to represent all or part of the name. 

ALARM_NAME=(alarm-name,...) 

Specifies the alarm journal name on which selection is based. You can use 
wildcards to represent all or part of the alarm name. 

ASSOCIATION_NAME=(IPC-name,...) 

Specifies the name of the interprocess communication (IPC) association. 

AUDIT_NAME=(journal-name,...) 

Specifies the audit journal name on which selection is based. You can use 
wildcards to represent all or part of the audit journal name. 

COMMAND_LINE=(command,...) 

Specifies the command line that the user entered. 

CONNECTION JDENTIFICATION=(IPC-name,...) 

Specifies the name for the interprocess communication (IPC) connection. 

DECNET_LINK_IDENTIFICATION=(value,...) 

Specifies the number of the DECnet logical link. 

DECNET_OBJECT_NAME=(object-name,...) 

Specifies the name of the DECnet object. 

DECNET_OBJECT_NUMBER=(value,...) 

Specifies the number of the DECnet object. 

DEFAULT_USERNAME=(username,...) 

Specifies the default local user name for incoming network proxy requests. 
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DEVICE_NAME=(device-name,...) 

Specifies the name of a device in audit records that have a DEVICE_NAME 
packet. Note that this does not select the device name when it occurs in other 
packet types, such as in a file name or in the TARGET_DEVICE_NAME packet. 

DIRECTORY_ENTRY=(directory,...) 

Specifies the directory entry associated with file system operation. 

DIRECTORY_NAME=(directory,...) 

Specifies the name of the directory file. 

DISMOUNT_FLAGS=(flag-name,...) 

Identifies the names of the volume dismounting flags to be used in selecting 
records. Specify one or more of the following flag names: Abort, Cluster, 
Nounload, and Unit. 

EVENT_CLUSTER_NAME=(event-flag-cluster-name,...) 

Specifies the name of the event flag cluster. 

FACILITY=(f acil ity-name,...) 

Specifies that only events audited by the named facility be selected. Provide a 
name or a number but, in either case, the facility has to be defined through the 
logical AUDSERV$FACILITY_NAME as a decimal number; the system uses the 
number 0. 

FIELD_NAME=(field-name,...) 

Specifies the name of the field that was modified. ANALYZE/AUDIT uses the 
FIELD_NAME criterion with packets containing the original data and the new 
data (specified by the NEW.DATA criterion). 

FILE_NAME=(file-name) 

Specifies the name of the file that caused the audit. Describes audit records for 
the specified file by using a slightly different display format than is provided by 
the /OBJECT=NAME=object-name keyword. 

FILEJDENTIFICATION=(identification-value) 

Specifies the value of the file’s identification. To calculate the value, start with 
the value listed for File ID when you use the FILE.NAME keyword. For example, 
if the display lists the File ID as: 

File ID: (3024,5,0) 

Use the following formula to calculate the value: 

((0 * 65536) + 5 * 65536) + 3024 = 330704 

FLAGS=(flag-name,...) 

Identifies the names of the audit event flags associated with the audited event. 
These names should be used in selecting records. Specify one or more of the 
following flags: ACL, Alarm, Audit, Flush, Foreign, Internal, and Mandatory. 
(For a description of these flags, see Table F—3.) 


4-14 






ANALYZE/AUDIT 

/SELECT 


HOLDER=keyword(,...) 

Specifies the characteristics of the identifier holder to be used when selecting 

event records. Choose from the following keywords: 

NAME=username Specifies the name of the holder. You can 

represent all or part of the name with a 
wildcard. 

OWNER=uic Specifies the user identification code (UIC) 

of the holder. 


IDENTIFIER=keyword(,...) 

Identifies which attributes of an identifier should be used when selecting event 
records. Choose from the following keywords: 


ATTRIBUTES=name 


NAME=identifier 


NEW_NAME=identifier 


Specifies the name of the particular 
attribute. Valid attribute names are 
as follows: Dynamic, Holder_Hidden, 
Name_Hidden, NoAccess, Resource, and 
Subsystem. 

Specifies the original name of the identifier. 
You can represent all or part of the name 
with a wildcard. 

Specifies the new name of the identifier. 
You can represent all or part of the name 
with a wildcard. 


NEW_ATTRIBUTES=name Specifies the name of the new attribute. 

Valid attribute names are Dynamic, 
Holder_Hidden, Name_Hidden, NoAccess, 
Resource, and Subsystem. 

VALUE=value Specifies the original value of the identifier. 

NEW_VALUE=value Specifies the new value of the identifier. 


IDENTIFIERS_MISSING=(identifier,„.) 

Specifies the identifiers missing in a failure to access an object. 

IDENTIFIERS_USED=(identifier,...) 

Specifies the identifiers used to gain access to an object. An event record matches 
if the specified list is a subset of the identifiers recorded in the event record. 

IMAGE_NAME=(image-name,...) 

Identifies the name of the image to be used when selecting event records. You can 
represent all or part of the image name with a wildcard. 
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INSTALL=keyword(,...) 

Specifies that installation event packets are to be considered when selecting event 

records. Choose from the following keywords: 

FILE=filename Specifies the name of the installed file. You 

can represent all or part of the name with 
a wildcard. 

Note that on Alpha systems prior to 
Version 6.1 and on VAX systems prior 
to Version 6.0, audit log files record 
the installed file name within an object 
name packet. To select the installed 
file, you must use the expression 
OBJECT=(NAME=filename) instead of 
FILE=filename. 

FLAGS=flag-name Specifies the names of the flags, which 

correspond to qualifiers of the Install 
utility (INSTALL); for example, OPEN 
corresponds to /OPEN. 

PRIVILEGES=privilege-name Specifies the names of the privileges with 

which the file was installed. 

LNM_PARENT_NAME=(table-name,...) 

Specifies the name of the parent logical name table. 

LNM_TABLE_NAME=(table-name,...) 

Specifies the name of the logical name table. 

LOCAL=(characteristic,...) 

Specifies the characteristics of the local (proxy) account to be used when selecting 

event records. The following characteristic is supported: 

USERNAME=username Specifies the name of the local account. 

You can represent all or part of the name 
with a wildcard. 


LOGICAL_NAME=(logical-name,...) 

Specifies the logical name of the mounted (or dismounted) volume upon which 
selection is based. You can represent all or part of the logical name with a 
wildcard. 

MAILBOX_UNIT=(number,...) 

Specifies the number of the mailbox unit. 

MOUNT_FLAGS=(flag-name,...) 

Specifies the names of the volume mounting flags upon which selection is based. 
Possible flag names include the following: 

CACHE=(NONE,WRITETHROUGH) 

CD-ROM 

CLUSTER 

COMPACTION 

DATACHECK=(READ,WRITE) 

DSI 

FOREIGN 

GROUP 
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INCLUDE 

INITIALIZATION=(ALLOCATE,CONTINUATION) 

MESSAGE 

NOASSIST 

NOAUTOMATIC 

NOCOMPACTION 

NOCOPY 

NOHDR3 

NOJOURNAL 

NOLABEL 

NOMOUNT.VERIFICATION 

NOQUOTA 

NOREBUILD 

NOUNLOAD 

NOWRITE 


OVERRIDE=(options[,...]) 


ACCESSIBILITY 

EXPIRATION 

IDENTIFICATION 

LIMITED_SEARCH 

LOCK 

NO_FORCED_ERROR 

OWNER.IDENTIFIER 

SECURITY 

SETID 


QUOTA 

SHARE 

SUBSYSTEM 

SYSTEM 

TAPE_DATA_WRITE 

XAR 


The names NOLABEL and FOREIGN each point to the FOREIGN flag. The 
reason for this is that the MOUNT/NOLABEL and MOUNT/FOREIGN commands 
each set the FOREIGN flag. Therefore, if you used MOUNT/NOLABEL, and you 
use ANALYZE/AUDIT/SELECT/MOUNT_FLAGS=NOLABEL, the audit record 
will display the FOREIGN flag. 


NEW_DATA=(value,...) 

Specifies the value to use after the event occurs. Use this criterion with the 
FIELD_NAME criterion.) 


NEW_IMAGE_NAME=(image-name,...) 

Specifies the name of the image to be activated in the newly created process, as 
supplied to the $CREPRC system service. 


NEW_OWNER=(uic,...) 

Specifies the user identification code (UIC) to be assigned to the created process, 
as supplied to the $CREPRC system service. 
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OBJECT=keyword(,„.) 

Specifies which characteristics of an object should be used when selecting event 
records. Choose any of the following keywords: 

CLASS=class-name Specifies the general object class as one of 

the following: 

Capability 

Device 

Event_cluster 

File 

Group_global_section 

Logical_name_table 

Queue 

Resource_domain 

Security_class 

System_global_section 

Volume 

You must enter the full class name (for 
example, CLASS=logical_name_table) 
or use wildcard characters to supply a 
portion of the class name (for example, 
CLASS=log*). 

NAME=object-name Specifies the name of the object. You can 

represent all or part of the name with a 
wildcard. If you do not use a wildcard, 
specify the full object name (for example, 
BOSTON$DUAO:[RWOODS]MEMO.MEM;1). 

OWNER=value Specifies the UIC or general identifier of 

the object. 

TYPE=type Specifies the general object class (type 

of object). The available classes are as 
follows: 

Capability 

Device 

File 

Group_global_section 

Logical_name_table 

Queue 

System_global_section 
The CLASS keyword supersedes the TYPE 
keyword. However, TYPE is required 
to select audit records in files created 
prior to OpenVMS Alpha Version 6.1 and 
OpenVMS VAX Version 6.0. 


PARENT=keyword(,...) 

Specifies which characteristics of the parent process are used when selecting 
event records generated by a subprocess. Choose from the following keywords: 

IDENTIFICATION value Specifies the process identification (PID) of 

the parent process. 
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NAME=process-name 


OWNER=value 

USERNAME=usemame 


Specifies the name of the parent process. 
You can represent all or part of the name 
with a wildcard. 

Specifies the owner (identifier value) of the 
parent process. 

Specifies the user name of the parent 
process. You can represent all or part of 
the name with a wildcard. 


PASSWORD=(password,...) 

Specifies the password used when the system detected a break-in attempt. 

PRIVILEGES_MISSING=(privilege-name,...) 

Specifies privileges the caller needed to perform the operation successfully. 
Specify any of the system privileges, as described in the OpenVMS Guide to 
System Security. 


PRIVILEGES_USED=(privilege-name,...) 

Specifies the privileges of the process to be used when selecting event records. 
Specify any of the system privileges, as described in the OpenVMS Guide to 
System Security. Also include the STATUS keyword in the selection criteria so 
the report can demonstrate whether the privilege was involved in a successful or 
an unsuccessful operation. 

PROCESS=(characteristic,...) 

Specifies the characteristics of the process to be used when selecting event 
records. Choose from the following characteristics: 


IDENTIFICATION=value Specifies the PID of the process. 

NAME=process-name Specifies the name of the process. You can 

represent all or part of the name with a 
wildcard. 


REMOTE=keyword(,„.) 

Specifies that some characteristic of the network request is to be used when 
selecting event records. Choose from the following keywords: 


ASSOCIATION_NAME=IPC-name 

LINK_IDENTIFICATION=value 

IDENTIFICATION=value 
NODENAME=node-name 

USERNAME=username 


Specifies the interprocess communication 
(IPC) association name. 

Specifies the number of the DECnet logical 
link. 

Specifies the DECnet node address. 

Specifies the DECnet node name. You can 
represent all or part of the name with a 
wildcard. 

Specifies the remote user name. You can 
represent all or part of the remote user 
name with a wildcard. 


REQUEST_NUMBER=(value,...) 

Specifies the request number associated with the DCL command REQUEST 
/REPLY. 
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SECTION JYAME=(global-section-name,...) 

Specifies the name of the global section. 

SNAPSHOT_BOOTFILE=(filename,...) 

Specifies the name of the file containing a snapshot of the system. 

SNAPSHOT_SAVE_FILENAME=(filename,...) 

Specifies the name of the system snapshot file for a save operation that is in 
progress. 

STATUS=type(,...) 

Specifies the type of success status to be used when selecting event records. 
Choose from the following status types: 

SUCCESSFUL Specifies any success status. 

FAILURE Specifies any failure status. 

CODE=(value,...) Specifies a specific completion status. 

SUBJECT_OWNER=(uic,...) 

Specifies the owner (UIC) of the process causing the event. 

SYSTEM=keyword(,...) 

Specifies the characteristics of the system to be used when selecting event 
records. Choose from the following keywords: 

IDENTIFICATION=value Specifies the numeric identification of the 

system. 

NAME=nodename Specifies the node name of the system. 

SYSTEM_SERVICE_NAME=(service-name,...) 

Specifies the name of the system service associated with the event. 

TARGET_DEVICE_NAME=(device-name,...) 

Specifies the target device name used by a process control system service. 

TARGET_PROCESSJDENTIFICATION=(value,...) 

Specifies the target process identifier (PID) used by a process control system 
service. 

TARGET_PROCESS_NAME=(process-name,...) 

Specifies the target process name used by a process control system service. 

TARGET_PROCESS_OWNER=(uic,...) 

Specifies the target process owner (UIC) used by a process control system service. 

TARGET_USERNAME=(username,...) 

Specifies the target user name used by a process control system service. 

TERMINAL=(device-name,...) 

Specifies the name of the terminal to be used when selecting event records. You 
can represent all or part of the terminal name with a wildcard. 

TRANSPORT_NAME=(transport-name,...) 

Specifies the name of the transport: interprocess communication (IPC) or 
System Management Integrator (SMI), which handles requests from the System 
Management utility. 
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On VAX systems, it also can specify the DECnet transport name (NSP).4 

USERNAME=(username,...) 

Specifies the user name to be used when selecting event records. You can 
represent all or part of the user name with a wildcard. 

VOLUME_NAME=(volume-name,...) 

Specifies the name of the mounted (or dismounted) volume to be used when 
selecting event records. You can represent all or part of the volume name with a 
wildcard. 

VOLUME_SET_NAME=(volume-set-name,...) 

Specifies the name of the mounted (or dismounted) volume set to be used when 
selecting event records. You can represent all or part of the volume set name 
with a wildcard. 


Examples 


1. $ ANALYZE/AUDIT /FULL/SELECT=USERNAME=JOHNSON - 
_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example selects all records written to the security audit 
log file that were generated by user JOHNSON. 

2. $ ANALYZE/AUDIT/FULL/SELECT=PRIVILEGES_USED=(SYSPRV,- 
_$ BYPASS) SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example selects all records written to the security audit 
log file that were generated by events through the use of either SYSPRV or 
BYPASS privilege. 

3. $ ANALYZE/AUDIT/FULL/EVENT=SYSUAF/SELECT= - 

_$IMAGE=(''*: [SYS*SYSEXE]SETP0.EXE", [SYS*SYSEXE]LOGINOUT.EXE") - 
_$SYS$MANAGER:SECURITY 

The command in this example selects all records written to the security audit 
log file that involve password changes. 

The following is a command procedure that you could run at midnight to 
select all SYSUAF, AUDIT, and BREAKIN events (excluding password 
changes) and mail the result to the system manager: 
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$! DAILY_AUDIT.COM 

$ 

$ mail.list = "SYSTEM" 

$ audsrv$_noselect = %X003080A0 
$ audit.events = "SYSUAF,BREAKIN,AUDIT" 

$ 

$ analyze /audit /full - 
/event=('audit_events') - 
/output=audit.tmp - 

/ignore=image=("*:[SYS*SYSEXE]SETP0.EXE",[SYS*SYSEXE]L0GIN0UT.EXE") - 
sys$manager:SECURITY.AUDIT$JOURNAL 

$ 

$ status = $status 

$ if (status.and.%XFFFFFFF) .eq. audsrv$_noselect then goto no_records 
$ if .not. status then goto error_analyze 
$ if f$file("audit.tmp","eof") .eq. 0 then goto no_records 
$ mail /subject="''audit_events' listing from ''f$time()'" - 
audit.tmp 'mail_list' 

$ goto new_log 

$ 

$ no_records: 

$ mail /subject="No interesting security events" nl: 'mail_list' 

$ 

$ new_log: 

$ if f$search("audit.tmp") .nes. "" then delete audit.tmp;* 

$ set audit /server=new_log 

$ rename sys$manager:SECURITY.AUDITSJOURNAL;-l - 
sys$common:[sysmgr]'f$element(0," ", f$edit(f$time(),"TRIM"))' 

$ exit 

$ 

$ error_analyze: 

$ mail/subj="Error analyzing auditing information" nl: 'mailJList' 

$ exit 


/SINCE 

Indicates the utility must operate on records dated with the specified time or 
after the specified time. 

Format 

/SINCE[=time] 

/NOSINCE 

Keyword 

time 

Specifies the time used to select records. Records dated the same or later than 
the specified time are selected. You can specify an absolute time, a delta time, or 
a combination of the two. Observe the syntax rules for date and time described in 
the OpenVMS User's Manual. 

If you specify /SINCE without the time, the utility uses the beginning of the 
current day. 
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Examples 


/SUMMARY 


Format 


Keyword 


Examples 


1. $ ANALYZE/AUDIT /SINCE=25-NOV-1994 - 
_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example selects records dated later than 
November 25, 1994. 

2. $ ANALYZE/AUDIT /SINCE=25-NOV-1994:15:00 - 
_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example selects records written after 3 P.M. on November 
25, 1994. 


Specifies that a summary of the selected records be produced after all records are 
processed. 

You can use the /SUMMARY qualifier alone or in combination with the /BRIEF, 
the /BINARY, or the /FULL qualifier. 


/SUMMARY=presentation 

/NOSUMMARY 


presentation 

Specifies the presentation of the summary. If you do not specify a presentation 
criterion, ANALYZE/AUDIT summarizes the number of audits. 

You can specify either of the following presentations: 

COUNT 

Lists the total number of audit messages for each class of security event that 
have been extracted from the security audit log file. This is the default. 

PLOT 

Displays a plot showing the class of the audit event, the time of day when the 
audit was generated, and the name of the system where the audit was generated. 


1. $ ANALYZE/AUDIT/SUMMARY SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example generates a summary report of all records 
processed. 
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Total records read: 
Record buffer size: 
Successful logins: 
Successful logouts: 
Login failures: 
Breakin attempts: 
System UAF changes: 
Rights db changes: 
Netproxy changes: 
Audit changes: 
Installed db changes: 
Sysgen changes: 

NCP command lines: 


9701 Records selected: 9701 

1031 

542 Object creates: 1278 

531 Object accesses: 3761 

35 Object deaccesses: 2901 

2 Object deletes: 301 

10 Volume (dis)mounts: 50 

8 System time changes: 0 

5 Server messages: 0 

7 Connections: 0 

50 Process control audits: 0 

9 Privilege audits: 91 

120 


2. $ ANALYZE/AUDIT/FULL/EVENT_TYPE=(BREAKIN,LOGFAIL)/SUMMARY- 

_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

The command in this example generates a full format listing of all logged 
audit messages that match the break-in or log failure event classes. A 
summary report is included at the end of the listing. 


3. $ ANALYZE/AUDIT/FULL/EVENTJTYPE= (BREAKIN, LCX3FAIL)/SUMMARY=PLOT - 

_$ SYS$MANAGER:SECURITY.AUDIT$JOURNAL 

This command generates a histogram that you can display on a character-cell 
terminal. 


Node: ATHENS 

10000101001020010300 10400 105001060010700|0800|09001100011100112001130011400115001160011700118001190012000121001220012300| 
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ANALYZE/AUDIT Commands 

This section describes the interactive commands available with the Audit 
Analysis utility (ANALYZE/AUDIT). The qualifiers for this section follow the 
standard rules of DCL grammar. 

The utility runs interactively by default; you disable the feature with the 
/NOINTERACTIVE qualifier to the ANALYZE/AUDIT command. To enter 
interactive commands, press Ctrl/C at any time during the processing of a full 
or brief interactive display. At the COMMAND> prompt, you can enter any of 
the commands listed in this section. Use the CONTINUE command to resume 
processing of the event records, or use the EXIT command to terminate the 
session. 


CONTINUE 


Resumes processing of event records. 

Format 


CONTINUE 

Parameters 

None. 

Qualifiers 

None. 

Example 

C0MMAND> DISPLAY/SINCE=25-JAN-19 9 5/SELECT=USERNAME=JOHNSON 
C0MMAND> CONTINUE 

The first command in this example selects only event records generated by user 
JOHNSON after January 25, 1995. The second command in the example displays 
a report based on the new selection criteria. 


DISPLAY 


Changes the criteria used to select event records. 


Format 

DISPLAY 


Parameters 

None. 

For a more complete description of any one of the following qualifiers, refer to the 
description of the qualifier in the preceding Analyze/Audit Qualifiers section. 
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Qualifiers 

/BEFORE=time 

Controls whether only those records dated earlier than the specified time are 
selected. 

/BR|EF 

Controls whether a brief (one-line-per-record) format is used in ASCII displays. 

/EVENTTYPE=event-type[,...] 

Controls whether only those records matching the specified event type are 
selected. 

/FULL 

Controls whether a full format for each record is used in ASCII displays. 

/IGNORE=criteria[,...] 

Controls whether records matching the specified criteria are excluded. If you 
specify /IGNORE two or more times, the criteria are combined. To specify a 
new set of exclusion criteria, include the /REMOVE qualifier with the /IGNORE 
qualifier. 

/PAUSE=seconds 

For full-format displays (/FULL), specifies the length of time each record is 
displayed. 

/REMOVE 

Controls whether the criteria specified by the /IGNORE and the /SELECT 
qualifiers are no longer to be used to select event records to be displayed. 

/SELECT=criteria[,...] 

Controls whether only those records matching the specified criteria are selected. 

If you specify /SELECT two or more times, the criteria are combined. To specify 
a new set of selection criteria, include the /REMOVE qualifier with the /SELECT 
qualifier. 

/SINCE[=time] 

Controls whether only those records dated the same or later than the specified 
time are selected. 

Examples 

1. COMMAND> DISPLAY/EVENT_TYPE=.SYSUAF 

C0MMAND> CONTINUE 

The first command in this example selects records that were generated as a 
result of a modification to the system user authorization file (SYSUAF). The 
second command displays the selected records. 
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2. COMMAND> DISPLAY/SELECT=USERNAME=CRICK 
COMMAND> CONTINUE 


|CWC| 

COMMAND> DISPLAY/SELECT=USERNAME=WATSON 
COMMAND> CONTINUE 

The first DISPLAY command in this example selects records that were 
generated by user CRICK. The second command displays the selected records. 
The next DISPLAY command selects records that were generated by user 
WATSON. The last command in the example displays all records generated by 
users CRICK and WATSON. 


EXIT 


Terminates the session. 


Format 

EXIT 

Parameters 

None. 


Qualifiers 


None. 


HELP 


Provides online help information for using ANALYZE/AUDIT commands. 

Format 

HELP [topic] 

Parameter 

topic 

Specifies the command for which help information is to be displayed. If you omit 
the keyword, HELP displays a list of available help topics and prompts you for a 
particular keyword. 


Qualifiers 


None. 


Example 


COMMAND> HELP DISPLAY 

The command in this example displays help information about the DISPLAY 
command. 
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LIST 

Changes the criteria used to select event records. The LIST command is 
synonymous with the DISPLAY command. 

Format 

LIST 


Parameters 

None. 


Qualifiers 

See the description of the DISPLAY command. 

Example 

C0MMAND> LIST/EVENT_TYPE=SYSUAF 

COMMAND> CONTINUE 

The first command in this example selects records that were generated as a result 
of a modification to the system user authorization file (SYSUAF). The second 
command displays the selected records. 


NEXT FILE 


Format 

Controls whether the current security audit log file is closed and the next log file 
opened. The command is useful when you supply a wildcard file specification to 
the ANALYZE/AUDIT command; for example *.AUDIT$JOURNAL. If there are 
no other audit log files to open, the audit analysis session terminates and control 
returns to DCL. 

NEXT FILE 


Parameters 

None. 

Qualifiers 

None. 
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NEXT RECORD 


Controls whether the next audit record is displayed. The NEXT RECORD 
command is the default for interactive mode. 

This command is synonymous with the POSITION command. 

Format 

NEXT RECORD 


Parameters 

None. 

Qualifiers 

None. 


POSITION 

Moves the full-format display forward or backward the specified number of event 
records. 

Format 

POSITION number 

Parameter 

number 

For positive numbers, displays the record that is the specified number of records 
after the current record. For negative numbers, displays the record that is the 
specified number of records before the current record. 

Qualifiers 

None. 

Examples 

1. C0MMAND> POSITION 100 

The command in this example moves the display forward 100 event records. 

2. COMMAND> POSITION -100 

The command in this example moves the display back 100 event records. 


4-29 






ANALYZE/AUDIT 

SHOW 


SHOW 



Displays information about the selection or exclusion criteria currently being used 
to select event records. 

Format 

SHOW option[,...] 

Parameter 

option[,...] 

Displays information about selection or exclusion criteria currently being used to 

select records. Specify one or more of the following options: 

ALL Displays all criteria being used to select event 

records. 

EXCLUSION_CRITERIA Displays the criteria being used to exclude event 

records. 

SELECTION_CRITERIA Displays the criteria being used to select event 

records. 

Qualifiers 

None. 

Example 

C0MMAND> SHOW SELECTION_CRITERIA 

The command in this example displays the selection criteria currently in use to 
select records. 
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AUTHORIZE Description 

The Authorize utility (AUTHORIZE) is a system management tool used to control 
access to the system and to allocate resources to users. AUTHORIZE creates new 
records or modifies existing records in the following files: 

• System user authorization file (SYSUAF.DAT) 

You can use AUTHORIZE to assign values to various fields within each 
SYSUAF record. The values you assign identify the user and the user’s work 
environment, and control use of system resources. 




Alpha 


• Network proxy authorization file 

On VAX systems, the default network proxy authorization file 
is NET$PROXY.DAT. However, AUTHORIZE maintains the file 
NETPROXY.DAT for compatibility. ♦ 

On Alpha systems, the network proxy authorization file is NETPROXY.DAT. ♦ 

In a mixed-version cluster where systems are running OpenVMS Alpha 
or a version of OpenVMS VAX earlier than 6.1, you must make all proxy 
modifications on an OpenVMS VAX 6.1 system. 

• Rights database file (RIGHTSLIST.DAT) 


These files store system authorization information. By default, they are owned by 
the system (UIC of [SYSTEM]) and are created with the following protection: 

SYSUAF.DAT S:RWED, 0:RWED, G, W 

NETPROXY.DAT S:RWED, 0:RWED, G:RWE, W 

NET$PROXY.DAT SrRWED, 0, G, W (VAX only) 

RIGHTSLIST.DAT S:RWED, 0:RWED, G:R, W: 


To use AUTHORIZE, you must have write access to all three of these files 
(in other words, you must have an account with the UIC of [SYSTEM] or the 
SYSPRV privilege). 

Note that you must have read access to the RIGHTSLIST.DAT file (or sufficient 
privileges) to display the rights identifiers held by other users. 

Because certain images (such as MAIL and SET) require access to the system 
UAF and are normally installed with the SYSPRV privilege, ensure that you 
always grant system access to SYSUAF.DAT. 

When you install a new system, the software distribution kit provides the 
following records in the system user authorization file in SYS$SYSTEM: 

DEFAULT 

FIELD 

SYSTEM 

SYSTEST 

SYSTEST_CLIG 


If the SYSUAF.DAT becomes corrupted or is accidentally deleted, you can use the 
template file SYSUAF.TEMPLATE in the SYS$SYSTEM directory to recreate the 
file, as follows: 


$ SET DEFAULT SYS$SYSTEM 
$ COPY SYSUAF.TEMPLATE SYSUAF.DAT 


The file SYSUAF.TEMPLATE contains records that are identical to those defined 
when the system was installed. 
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As an emergency backup for the system SYSUAF file, you can create a 
private copy of SYSUAF.DAT. To affect future logins, copy a private version of 
SYSUAF.DAT to the appropriate directory, as shown in the following example: 

$ COPY MYSYSUAF.DAT SYS$C0MM0N:[SYSEXE]:SYSUAF.DAT- 
_$ /PROTECTION(S:RWED,0:RWED,G,W) 
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AUTHORIZE Usage Summary 

The Authorize utility (AUTHORIZE) is a system management tool that enables 
you to control access to the system and to allocate resources to users. 

Format 


RUN SYS$SYSTEM:AUTHORIZE 

Parameters 

None. 

Usage Summary 

To invoke AUTHORIZE, set your default device and directory to SYS$SYSTEM 
and enter RUN AUTHORIZE at the DCL command prompt. At the UAF> 
prompt, you can enter any of the AUTHORIZE commands described in the 
following section. 

To exit from AUTHORIZE, enter the EXIT command at the UAF> prompt or 
press Ctrl/Z. 

If you move the SYSUAF.DAT file, be sure the logical name SYSUAF is 
defined and points to an existing file. If AUTHORIZE is unable to locate the 
SYSUAF.DAT file, it displays the following error message: 

%UAF-E-NAOFIL, unable to open SYSUAF.DAT 
-RMS-E-FNF, file not found 
Do you want to create a new file? 

A response of YES results in creation of a new SYSUAF file containing a 
SYSTEM record and a DEFAULT record. These records are initialized with the 
same values set when the system was installed. 






AUTHORIZE Commands 

This section describes the AUTHORIZE commands and provides examples of 

their use. You can abbreviate any command, keyword, or qualifier as long as the 

abbreviation is not ambiguous. The asterisk (*) and the percent sign (%) can be 

used as wildcard characters to specify user names, node names, and UICs. 

AUTHORIZE commands fall into the following four categories: 

• Commands that allow you to manage user authorization records. By 
specifying appropriate qualifiers, you can use these commands to act upon 
individual fields of SYSUAF records. You can identify the user and the user’s 
work environment and control use of system resources. 

• Commands that build and maintain the network proxy authorization file 
(NETPROXY.DAT or NET$PROXY.DAT). 

• Commands that create and maintain the rights database (RIGHTSLIST.DAT). 

• Commands that perform general utility functions or modify the system 
password. 

Table 5-1 summarizes the AUTHORIZE commands according to these categories. 


Table 5-1 AUTHORIZE Command Summary 
Command Description 


Managing System Resources and User Accounts with SYSUAF 


ADD 

Adds a user record to the SYSUAF and 
corresponding identifiers to the rights 
database. 

COPY 

Creates a new SYSUAF record that duplicates 
an existing record. 

DEFAULT 

Modifies the default SYSUAF record. 

LIST 

Writes reports for selected UAF records to a 
listing file, SYSUAF.LIS. 

MODIFY 

Changes values in a SYSUAF user record. 
Qualifiers not specified in the command 
remain unchanged. 

REMOVE 

Deletes a SYSUAF user record and 
corresponding identifiers in the rights 
database. The DEFAULT and SYSTEM 
records cannot be deleted. 

RENAME 

Changes the user name of the SYSUAF record 
(and, if specified, the corresponding identifier) 
while retaining the characteristics of the old 
record. 

SHOW 

Displays reports for selected SYSUAF records. 

(continued on next page) 


5-6 












AUTHORIZE Commands 


Table 5-1 (Cont.) AUTHORIZE Command Summary 


Command Description 


Managing Network Proxies with NETPROXY.DAT or NET$PROXY.DAT 


ADD/PROXY 

Adds proxy access for the specified user. 

CREATE/PROXY 

Creates a network proxy authorization file. 

LIST/PROXY 

Creates a listing file of all proxy accounts 
and all remote users with proxy access to the 
accounts. 

MODIFY/PROXY 

Modifies proxy access for the specified user. 

REMOVE/PROXY 

Deletes proxy access for the specified user. 

SHOW/PROXY 

Displays proxy access allowed for the specified 
user. 


Managing Identifiers with RIGHTSLIST.DAT 


ADD/IDENTIFIER 

Adds an identifier name to the rights 
database. 

CREATE/RIGHTS 

Creates a new rights database file. 

GRANT/IDENTIFIER 

Grants an identifier name to a UIC identifier. 

LIST/IDENTIFIER 

Creates a listing file of identifier names and 
values. 

LIST/RIGHTS 

Creates a listing file of all identifiers held by 
the specified user. 

MODIFY/IDENTIFIER 

Modifies the named identifier in the rights 
database. 

REMOVE/IDENTIFIER 

Removes an identifier from the rights 
database. 

RENAME/IDENTIFIER 

Renames an identifier in the rights database. 

REVOKE/IDENTIFIER 

Revokes an identifier name from a UIC 
identifier. 

SHOW/IDENTIFIER 

Displays identifier names and values on the 
current output device. 

SHOW/RIGHTS 

Displays on the current output device the 
names of all identifiers held by the specified 
user. 

General Commands 

EXIT 

Returns the user to DCL command level. 

HELP 

Displays HELP text for AUTHORIZE 
commands. 

MODIFY/SYSTEM_PASSWORD 

Sets the system password (equivalent to the 
DCL command SET PASSWORD/SYSTEM). 
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ADD 


Adds a user record to the SYSUAF and corresponding identifiers to the rights 
database. 


Format 

ADD newusername 


Parameter 

newusername 

Specifies the name of the user record to be included in the SYSUAF. The 
newusername parameter is a string of 1 to 12 alphanumeric characters and 
can contain underscores. Although dollar signs are permitted, they are usually 
reserved for system names. 

Avoid using fully numeric user names (for example, 89560312). A fully numeric 
user name cannot receive a corresponding identifier because fully numeric 
identifiers are not permitted. 


Qualifiers 


/ACCESS[=(range[,...])] 

Specifies hours of access for all modes of access. The syntax for specifying the 
range is: 

/[NO]ACCESS=([PRIMARY], [n-m], [n], [,...],[SECONDARY], [n-m], [n], [,...]) 

Specify hours as integers from 0 to 23, inclusive. You can specify single hours 
(n) or ranges of hours (n-m). If the ending hour of a range is earlier than the 
starting hour, the range extends from the starting hour through midnight to 
the ending hour. The first set of hours after the keyword PRIMARY specifies 
hours on primary days; the second set of hours after the keyword SECONDARY 
specifies hours on secondary days. Note that hours are inclusive ; that is, if you 
grant access during a given hour, access extends to the end of that hour. 

By default, a user has full access every day. See the DCL command SET DAY 
in the OpenVMS DCL Dictionary for information on overriding the defaults for 
primary and secondary day types. 

All the list elements are optional. Unless you specify hours for a day type, access 
is permitted for the entire day. By specifying an access time, you prevent access 
at all other times. Adding NO to the qualifier denies the user access to the 
system for the specified period of time. 

Examples: 


/ACCESS 

/NOACCESS=SECONDARY 

/ACCESS=(9-17) 

/NOACCESS=(PRIMARY, 9-17, 
SECONDARY, 18-8) 


Allows unrestricted access 
Allows access on primary days only 

Allows access from 9 A.M. to 5:59 P.M. on 
all days 

Disallows access between 9 A.M. to 5:59 
P.M. on primary days but allows access 
during these hours on secondary days 


To specify access hours for specific types of access, see the /BATCH, /DIALUP, 
/INTERACTIVE, /LOCAL, /NETWORK, and /REMOTE qualifiers. 
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/ACCOUNT=account-name 

Specifies the default name for the account (for example, a billing name or 
number). The name can be a string of 1 to 8 alphanumeric characters. By 
default, AUTHORIZE does not assign an account name. 

/ADDJDENTIFIER (default) 

/NOADD JDENTIFIER 

Adds a user (user name and account name) to the rights database. The /NOADD 
IDENTIFIER does not create a rights list identifier (user name and account 
name). 

/ALGORITHM=keyword=type [=value] 

Sets the password encryption algorithm for a user. The keyword VMS refers 
to the algorithm used in the operating system version that is running on your 
system, whereas a customer algorithm is one that is added through the $HASH_ 
PASSWORD system service by a customer site, by a layered product, or by a 
third party. The customer algorithm is identified in $HASH_PASSWORD by an 
integer in the range of 128 to 255. It must correspond with the number used 
in the AUTHORIZE command MODIFY/ALGORITHM. By default, passwords 
are encrypted with the VMS algorithm for the current version of the operating 
system. 


Keyword 

Function 

BOTH 

CURRENT 

PRIMARY 

SECONDARY 

Set the algorithm for primary and secondary passwords. 

Set the algorithm for the primary, secondary, both, or no 
passwords, depending on account status. CURRENT is the 
default value. 

Set the algorithm for the primary password only. 

Set the algorithm for the secondary password only. 

The following table lists password encryption algorithms: 

Type 

Definition 

VMS 

CUSTOMER 

The algorithm used in the version of the operating system 
that is running on your system. 

A numeric value in the range of 128 to 255 that identifies a 
customer algorithm. 

The following example selects the VMS algorithm for Sontag’s primary password: 


UAF> MODIFY SONTAG/ALGORITHM=PRIMARY=VMS 


If you select a site-specific algorithm, you must give a value to identify the 
algorithm, as follows: 

UAF> MODIFY SONTAG/ALGORITHM=CURRENT=CUSTOMER=128 

/ASTLM=value 

Specifies the AST queue limit, which is the total number of asynchronous system 
trap (AST) operations and scheduled wake-up requests that the user can have 
queued at one time. The default is 40 on VAX systems and 250 on Alpha systems. 
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/BATCH[=(range[,...])] . , „ , . .. ... 

Specifies the hours of access permitted for batch jobs. For a description ot the 
range specification, see the /ACCESS qualifier. By default, a user can submit 
batch jobs any time. 

/BIOLM=value 

Specifies a buffered I/O count limit for the BIOLM field of the UAF record. The 
buffered I/O count limit is the maximum number of buffered I/O operations, such 
as terminal I/O, that can be outstanding at one time. The default is 40 on VAX 
systems and 150 on Alpha systems. 

/BYTLM=value 

Specifies the buffered I/O byte limit for the BYTLM field of the UAF record. The 
buffered I/O byte limit is the maximum number of bytes of nonpaged system 
dynamic memory that a user’s job can consume at one time. Nonpaged dynamic 
memory is used for operations such as I/O buffering, mailboxes, and file-access 
windows. The default is 32768 on VAX systems and 64000 on Alpha systems. 

/CLI=cli-name 

Specifies the name of the default command language interpreter (CLI) for the 
CLI field of the UAF record. The cli-name is a string of 1 to 31 alphanumeric 
characters and should be either DCL or MCR. The default is DCL. This setting is 
ignored for network jobs. 

/CLITABLES=filespec 

Specifies user-defined CLI tables for the account. The filespec can contain 1 to 
31 characters. The default is SYS$LIBRARY:DCLTABLES. Note that this setting 
is ignored for network jobs to guarantee that the system-supplied command 
procedures used to implement network objects function properly. 

/CPUTIME=time 

Specifies the maximum process CPU time for the CPU field of the UAF record. 
The maximum process CPU time is the maximum amount of CPU time a 
user’s process can take per session. You must specify a delta time value. For a 
discussion of delta time values, see the OpenVMS User’s Manual. The default is 
0, which means an infinite amount of time. 

/DEFPRIVILEGES=([NO]privname[,...]) 

Specifies default privileges for the user; that is, those enabled at login time. 

A NO prefix removes a privilege from the user. By specifying the keyword 
[NOJALL with the /DEFPRIVILEGES qualifier, you can disable or enable all user 
privileges. The default privileges are TMPMBX and NETMBX. 

/DEVICE=device-name 

Specifies the name of the user’s default device at login. The device-name is a 
string of 1 to 31 alphanumeric characters. If you omit the colon from the device¬ 
name value, AUTHORIZE appends a colon. The default device is SYS$SYSDISK. 

If you specify a logical name as the device-name (for example, DISKI: for DUAL), 
you must make an entry for the logical name in the LNM$SYSTEM_TABLE in 
executive mode by using the DCL command DEFINE/SYSTEM/EXEC. 

/DIALUP[=(range[,...])] 

Specifies hours of access permitted for dialup logins. For a description of the 
range specification, see the /ACCESS qualifier. The default is full access. 
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/DIOLM=value 

Specifies the direct I/O count limit for the DIOLM field of the UAF record. The 
direct I/O count limit is the maximum number of direct I/O operations (usually 
disk) that can be outstanding at one time. The default is 40 on VAX systems and 
150 on Alpha systems. 

/DIRECTORY=directory-name 

Specifies the default directory name for the DIRECTORY field of the UAF record. 
The directory name can be 1 to 39 alphanumeric characters. If you do not enclose 
the directory name in brackets, AUTHORIZE adds the brackets for you. The 
default directory name is [USER], 

/ENQLM=value 

Specifies the lock queue limit for the ENQLM field of the UAF record. The lock 
queue limit is the maximum number of locks that can be queued by the user at 
one time. The default is 200 on VAX systems and 2000 on Alpha systems. 

/EXPIRATION=time (default) 

/NOEXPIRATION 

Specifies the expiration date and time of the account. The /NOEXPIRATION 
qualifier removes the expiration date on the account or resets the expiration 
time for expired accounts. The default expiration time period is 90 days for 
nonprivileged users. 

/FILLM=value 

Specifies the open file limit for the FILLM field of the UAF record. The open file 
limit is the maximum number of files that can be open at one time, including 
active network logical links. The default is 300 on VAX systems and 100 on Alpha 
systems. 

/FLAGS=([NO]option[,...]) 

Specifies login flags for the user. The prefix NO clears the flag. The options are 
as follows: 

AUDIT 


AUTOLOGIN 


Enables or disables mandatory security auditing 
for a specific user. By default, the system 
does not audit the activities of specific users 
(NOAUDIT). 

Restricts the user to the automatic login 
mechanism when logging in to an account. When 
set, the flag disables login by any terminal that 
requires entry of a user name and password. The 
default is to require a user name and password 
(NOAUTOLOGIN). 
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CAPTIVE 


DEFCLI 

DISCTLY 


DISFORCE_PWD. 


DISIMAGE 

DISMAIL 

DISNEWMAIL 


Prevents the user from changing any defaults 
at login, for example, /CLI, /DISK, /COMMAND, 
or /LGICMD. It prevents the user from escaping 
the captive login command procedure specified 
by the /LGICMD qualifier and gaining access 
to the DCL command level. See Guidelines for 
Captive Command Procedures in the OpenVMS 
VAX Guide to System Security. 

The CAPTIVE flag also establishes an 
environment where Ctrl/Y interrupts are initially 
turned off; however, command procedures can 
still turn on Ctrl/Y interrupts with the DCL 
command SET CONTROL=Y. By default, an 
account is not captive (NOCAPTIVE). 

Restricts the user to the default command 
interpreter by prohibiting the use of the /CLI 
qualifier at login; the MCR command can still 
be used. By default, a user can choose a CLI 
(NODEFCLI). 

Establishes an environment where Ctrl/Y 
interrupts are initially turned off and are 
invalid until a SET CONTROL_Y is encountered. 
This could happen in SYLOGIN.COM or in a 
procedure called by SYLOGIN.COM. Once a SET 
CONTROL_Y is executed (which requires no 
privilege), a user can enter a Ctrl/Y and reach 
the DCL prompt ($). If the intent of DISCTLY 
is to force execution of the login command files, 
then SYLOGIN.COM should issue the DCL 
command SET CONTROL.Y to turn on Ctrl/Y 
interrupts before exiting. By default, Ctrl/Y is 
enabled (NODISCTLY). 

CHANGE Removes the requirement that a user must 

change an expired password at login. By default, 
a person can use an expired password only once 
(NODISFORCE_PWD_CHANGE) and then is 
forced to change the password after logging in. If 
the user does not select a new password, the user 
is locked out of the system. 

To use this feature, set a password expiration 
date with the PWDLIFETIME qualifier. 

Prevents the user from executing RUN, MCR, 
and foreign commands. By default, a user can 
execute RUN, MCR, and foreign commands 
(NODISIMAGE). 

Disables mail delivery to the user. By default, 
mail delivery is enabled (NODISMAIL). 
Suppresses announcements of new mail at login. 
By default, the system announces new mail 
(NODISNEWMAIL). 
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DISPWDDIC 

DISPWDHIS 

DISRECONNECT 

DISREPORT 

DISUSER 

DISWELCOME 

GENPWD 

LOCKPWD 

PWD.EXPIRED 


Disables automatic screening of new passwords 
against a system dictionary. By default, 
passwords are automatically screened 
(NODISPWDDIC). 

Disables automatic checking of new passwords 
against a list of the user’s old passwords. By 
default, the system screens new passwords 
(NODISPWDHIS). 

Disables automatic reconnection to an existing 
process when a terminal connection has been 
interrupted. By default, automatic reconnection 
is enabled (NODISRECONNECT). 

Suppresses reports of the last login time, login 
failures, and other security reports. By default, 
login information is displayed (NODISREPORT). 

Disables the account so the user cannot log in. 
For example, the DEFAULT account is disabled. 
By default, an account is enabled (NODISUSER). 

Suppresses the welcome message (an 
informational message displayed during a 
local login). This message usually indicates 
the version number of the operating system that 
is running and the name of the node on which 
the user is logged in. By default, a system login 
message appears (NODISWELCOME). 

Restricts the user to generated passwords. 

By default, users choose their own passwords 
(NOGENPWD). 

Prevents the user from changing the password 
for the account. By default, users can change 
their passwords (NOLOCKPWD). 

Marks a password as expired. The user cannot 
log in if this flag is set. The LOGINOUT.EXE 
image sets the flag when both of the following 
conditions exist: a user logs in with the 
DISFORCE_PWD_CHANGE flag set, and the 
user’s password expires. A system manager can 
clear this flag. By default, passwords are not 
expired after login (NOPWD_EXPIRED). 
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PWD2_EXPIRED Marks a secondary password as expired. 

Users cannot log in if this flag is set. The 
LOGINOUT.EXE image sets the flag when 
both of the following conditions exist: a user 
logs in with the DISFORCE_PWD_CHANGE 
flag set, and the user’s password expires. A 
system manager can clear this flag. By default, 
passwords are not set to expire after login 
(NOPWD2_EXPIRED). 

RESTRICTED Prevents the user from changing any defaults 

at login (for example, by specifying /DISK, 
/COMMAND, or /LGICMD) and prohibits user 
specification of a CLI with the /CLI qualifier. The 
RESTRICTED flag establishes an environment 
where Ctrl/Y interrupts are initially turned off; 
however, command procedures can still turn 
on Ctrl/Y interrupts with the DCL command 
SET CONTROL_Y. Typically, this flag is used 
to prevent an applications user from having 
unrestricted access to the CLI. By default, a user 
can change defaults (NORESTRICTED). 

This flag provides compatibility with CAPTIVE 
accounts in OpenVMS systems prior to Version 
5.2. 

/GENERATE_PASSWORD[=keyword] 

/NOGENERATE_PASSWORD (default) 

Invokes the password generator to create user passwords. Generated passwords 
can consist of 1 to 10 characters. Specify one of the following keywords: 


BOTH 

CURRENT 


PRIMARY 

SECONDARY 


Generate primary and secondary passwords. 

Do whatever the DEFAULT account does (for example, 
generate primary, secondary, both, or no passwords). This 
is the default keyword. 

Generate primary password only. 

Generate secondary password only. 


When you modify a password, the new password expires automatically; it is 
valid only once (unless you specify /NOPWDEXPIRED). On login, users are 
forced to change their passwords (unless you specify /FLAGS=DISFORCE_PWD_ 


CHANGE). 


Note that the /GENERATE.PASSWORD and /PASSWORD qualifiers are 
mutually exclusive. 


/INTERACTIVE! =(range[,...])] 

/NOINTERACTIVE 

Specifies the hours of access for interactive logins. For a description of the 
range specification, see the /ACCESS qualifier. By default, there are no access 
restrictions on interactive logins. 


/JTQUOTA=value 

Specifies the initial byte quota with which the jobwide logical name table is to 
be created. By default, the value is 4096 on VAX systems and 4096 on Alpha 
systems. 
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/LGICMD=filespec 

Specifies the name of the default login command file. The file name defaults to 
the device specified for /DEVICE, the directory specified for /DIRECTORY, a file 
name of LOGIN, and a file type of .COM. If you select the defaults for all these 
values, the file name is SYS$SYSTEM:[USER]LOGIN.COM. 

/LOCAL[=(range[,...])] 

Specifies hours of access for interactive logins from local terminals. For a 
description of the range specification, see the /ACCESS qualifier. By default, 
there are no access restrictions on local logins. 

/MAXACCTJOBS=value 

Specifies the maximum number of batch, interactive, and detached processes that 
can be active at one time for all users of the same account. By default, a user has 
a maximum of 0, which represents an unlimited number. 

/MAXDETACH=value 

Specifies the maximum number of detached processes with the cited user name 
that can be active at one time. To prevent the user from creating detached 
processes, specify the keyword NONE. By default, a user has a value of 0, which 
represents an unlimited number. 

/MAXJOBS=value 

Specifies the maximum number of processes (interactive, batch, detached, and 
network) with the cited user name that can be active simultaneously. The first 
four network jobs are not counted. By default, a user has a maximum value of 0, 
which represents an unlimited number. 

/NETWORK[=(range[,...])] 

Specifies hours of access for network batch jobs. For a description of how to 
specify the range, see the /ACCESS qualifier. By default, network logins have no 
access restrictions. 

/OWN E R=o wner-na me 

Specifies the name of the owner of the account. You can use this name for h illin g 
purposes or similar applications. The owner name is 1 to 31 characters. No 
default owner name exists. 

/PASSWORD=(password1[,password2]) 

/NOPASSWORD 

Specifies up to two passwords for login. Passwords can be from 0 to 32 characters 
in length and can include alphanumeric characters, dollar signs, and underscores. 
Avoid using the word password as the actual password. Use the /PASSWORD 
qualifier as follows: 

• To set only the first password and clear the second, specify 
/PASSWORD=password. 

• To set both the first and second password, specify /PASSWORD=(passwordl, 
password2). 

• To change the first password without affecting the second, specify 
/PASSWORD=(password, ""). 

• To change the second password without affecting the first, specify 
/PASSWORD^"", password). 

• To set both passwords to null, specify /NOPASSWORD. 
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When you modify a password, the new password expires automatically; it is valid 
only once (unless you specify /NOPWDEXPIRED). On login, the user is forced to 
change the password (unless you specify /FLAGS=DISFORCE_PWD_CHANGE). 

Note that the /GENERATE_PASSWORD and /PASSWORD qualifiers are 
mutually exclusive. 

By default, the ADD command assigns the password USER. When you create 
a new UAF record with the COPY or RENAME command, you must specify a 
password. Avoid using the word password as the actual password. 

/PBYTLM 

This flag is reserved for Digital. 

/PGFLQUOTA=value 

Specifies the paging file limit. This is the maximum number of pages that the 
person’s process can use in the system paging file. By default, the value is 32768 
pages on VAX systems and 50000 pagelets on Alpha systems. 

If decompressing libraries, make sure to set PGFLQUOTA to twice the size of the 
library. 

/PRCLM=value 

Specifies the subprocess creation limit. This is the maximum number of 
subprocesses that can exist at one time for the specified user’s process. By 
default, the value is 2 on VAX systems and 8 on Alpha systems. 

/PRIMEDAYS=([NO]day[,...]) . .. 

Defines the primary and secondary days of the week for logging in. Specify the 
days as a list separated by commas, and enclose the list in parentheses. To 
specify a secondary day, prefix the day with NO (for example, NOFRIDAY). To 
specify a primary day, omit the NO prefix. 

By default, primary days are Monday through Friday and secondary days are 
Saturday and Sunday. If you omit a day from the list, AUTHORIZE uses the 
default value. (For example, if you omit Monday from the list, AUTHORIZE 
defines Monday as a primary day.) 

Use the primary and secondary day definitions in conjunction with such qualifiers 
as /ACCESS, /INTERACTIVE, and /BATCH. 

/PRIORITY=value 

Specifies the default base priority. The value is an integer in the range of 0 to 31 
on VAX systems and 0 to 63 on Alpha systems. By default, the value is set to 4 
for timesharing users. 

/PRIVILEGES=([NO]privname[,...]) 

Specifies which privileges the user is authorized to hold, although these privileges 
are not necessarily enabled at login. (The /DEFPRIVILEGES qualifier determines 
which ones are enabled.) A NO prefix removes the privilege from the user. The 
keyword NOALL disables all user privileges. Many privileges have varying 
degrees of power and potential system impact (see the Security Guide for a 
detailed discussion). By default, a user holds TMPMBX and NETMBX privileges. 

/PWDEXPIRED (default) 

/NOPWDEXPIRED 

Specifies the password is valid for only one login. A user must change a password 
immediately after login or be locked out of the system. The system warns users 
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of password expiration. A user can either specify a new password, with the DCL 
command SET PASSWORD, or wait until expiration and be forced to change. By 
default, a user must change a password when first logging in to an account. The 
default is applied to the account only when the password is being modified. 

/PWDLIFETIME=time (default) 

/NOPWDLIFETIME 

Specifies the length of time a password is valid. Specify a delta time value in the 
form [dddd-] [hh:mm:ss.cc]. For example, for a lifetime of 120 days, 0 hours, and 
0 seconds, specify /PWDLIFETIME="120-". For a lifetime of 120 days 12 hours, 
30 minutes and 30 seconds, specify /PWDLIFETIME="120-12:30:30". If a period 
longer than the specified time elapses before the user logs in, the system displays 
a warning message. The password is marked as expired. 

To prevent a password from expiring, specify the time as NONE. By default, a 
password expires in 90 days. 

/PWDMINIMUM=value 

Specifies the minimum password length in characters. Note that this value 
is enforced only by the DCL command SET PASSWORD. It does not prevent 
you from entering a password shorter than the minimum length when you use 
AUTHORIZE to create or modify an account. By default, a password must have 
at least 6 characters. The value specified by the /PWDMINIMUM qualifier 
conflicts with the value used by the /GENERATE_PASSWORD qualifier or the 
DCL command SET PASSWORD/GENERATE, the operating system chooses the 
lesser value. The maximum value for generated passwords is 10. 

/REMOTE[=(range[,...])] 

Specifies hours during which access is permitted for interactive logins from 
network remote terminals (with the DCL command SET HOST). For a description 
of the range specification, see the /ACCESS qualifier. By default, remote logins 
have no access restrictions. 

/SHRFILLM=value 

Specifies the maximum number of shared files that the user can have open at one 
time. By default, the system assigns a value of 0, which represents an infini te 
number. 

/TQELM 

Specifies the total number of entries in the timer queue plus the number of 
temporary common event flag clusters that the user can have at one time. By 
default, a user can have 10. 

/UIC=value 

Specifies the user identification code (UIC). The UIC value is a group number in 
the range from 1 to 37776 (octal) and a member number in the range from 0 to 
177776 (octal), which are separated by a comma and enclosed in brackets. Digital 
reserves group 1 and groups 300-377 for its own use. 

Each user must have a unique UIC. By default, the UIC value is (200,200]. 

/WSDEFAULT=value 

Specifies the default working set limit. This represents the initial limit to the 
number of physical pages the process can use. (The user can alter the default 
quantity up to WSQUOTA with the DCL command SET WORKING_SET.) By 
default, a user has 256 pages on VAX systems and 2000 pagelets on Alpha 
systems. The value cannot be greater than WSMAX. 
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/WSEXTENT=value 

Specifies the working set maximum. This represents the maximum amount 
of physical memory allowed to the process. The system provides memory to a 
process beyond its working set quota only when it has excess free pages. The 
additional memory is recalled by the system if needed. The value is an integer 
equal to or greater than WSQUOTA. By default, the value is 1024 pages on VAX 
systems and 16384 pagelets on Alpha systems. The value cannot be greater than 
WSMAX. 

/WSQUOTA=value 

Specifies the working set quota. This is the maximum amount of physical 
memory a user process can lock into its working set. It also represents the 
maximum amount of swap space that the system reserves for this process and 
the maximum amount of physical memory that the system allows the process to 
consume if the systemwide memory demand is significant. The value cannot be 
greater than the value of WSMAX and cannot exceed 64K pages. 


Description 


Alpha 


When you do not specify a value for a field, AUTHORIZE uses values from the 
DEFAULT record (excluding the default password, which is always USER). The 
DEFAULT account serves as a template for creating user records in the system 
user authorization file. 

On Alpha systems, the DEFAULT account is as follows: 


Username: 
Account: 
CLI: 

Default: 
LGICMD: 


DEFAULT 


DCL 

SYS$SYSDEVICE:[USER] 
LOGIN 
Flags: DisUser 

Primary days: Mon Tue Wed Thu 
Secondary days: 

No access restrictions 


Owner: 
UIC: 
Tables: 


[ 200 , 200 ] 

DCLTABLES 


([FIELD,USERP]) 


Fri 


Sat Sun 


Expiration: (none) 

Pwdlifetime: 90 00:00 

Last Login: (none) 

Maxjobs: 

Maxacctjobs: 

Maxdetach: 

Prclm: 

Prio: 

Queprio: 

CPU: 

Authorized Privileges: 


Pwdminimum: 
Pwdchange: 
(interactive), 


Login Fails: 
(pre-expired) 
(none) 


(non-interactive) 


0 

Fillm: 

100 

Bytlm: 

64000 

0 

Shrfillm: 

0 

Pbytlm: 

0 

0 

BlOlm: 

150 

JTquota: 

4096 

8 

DIOlm: 

150 

WSdef: 

2000 

4 

ASTlm: 

250 

WSquo: 

4000 

0 

TQElm: 

10 

WSextent: 

16384 

(none) 

Enqlm: 

2000 

Pgflquo: 

50000 


TMPMBX NETMBX 
Default Privileges: 
TMPMBX NETMBX ♦ 
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0n VAX s y stem s, the DEFAULT account is as follows: 


Username: 
Account: 
CLI: 

Default: 

LGICMD: 


DEFAULT 


DCL 

SYS$SYSDEVICE:[USER] 

LOGIN 
Flags: DisUser 

Primary days: Mon Tue Wed Thu Fri 
Secondary days: 

No access restrictions 


Owner: 
UIC: 
Tables: 


[ 200 , 200 ] 

DCLTABLES 


([DEFAULT]) 


Sat Sun 


Expiration: 
Pwdlifetime: 

Last Login: 

Maxjobs: 0 

Maxacctjobs: 0 

Maxdetach: 0 

Prclm: 2 

Prio: 4 

Queprio: 0 

CPU: (none) 

Authorized Privileges: 

TMPMBX NETMBX 
Default Privileges: 
TMPMBX NETMBX ♦ 


(none) Pwdminimum: 6 Login Fails: 0 

90 00:00 Pwdchange: (pre-expired) 

(none) (interactive) (none) (non-interactive) 

Fillm: 300 Bytlm: 32768 

Shrfillm: 0 Pbytlm: 0 

BlOlm: 40 JTquota: 4096 

DIOlm: 40 WSdef: 256 

ASTlm: 40 WSquo: 512 

TQElm: 10 WSextent: 1024 

Enqlm: 200 Pgflquo: 32768 


When you add a new account, specify values for fields that you want to be 
different. Typically, changing the default values for limits^, priority, privileges, 
or the command interpreter is not necessary. As a result, you enter only the 
password, UIC, directory, owner, account, and device. 

When you add a record to the UAF, create a directory for the new user. Specify 
the device name, directory name, and UIC in the UAF record. The following DCL 
command creates a directory for user ROBIN: 

$ CREATE/DIRECTORY SYS$USER:[ROBIN] /OWNER_UIC=[ROBIN] 


Note 


When you add a new record to the UAF and a rights database exists, 
an identifier with the user name is added to the rights database 
automatically (unless you specify the /NOADD_IDENTIFIER qualifier). 
Similarly, when you specify an account name (other than the user 
name) that does not yet have an identifier, AUTHORIZE creates a group 
identifier in the rights database. 


Note that limits are also set by system parameters. To be effective, the limits you 
set through AUTHORIZE must be within the minimum limits determined by the 
corresponding system parameters (particularly those beginning with the PQL prefix). 
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Examples 

1. UAF> ADD ROBIN /PASSWORD=SP0152/UIC=[014,006] - 

_/DEVICE= SYS$USER/DIRECTORY=[ROBIN]/OWNER="JOSEPH ROBIN" /ACCOUNT=INV 
%UAF-I-ADDMSG, user record successfully added 

%UAF-I-RDBADDMSGU, identifier ROBIN value: [000014,000006] added to 
RIGHTSLIST.DAT 

%UAF-I-RDBADDMSGU, identifier INV value: [000014,177777] added to 
RIGHTSLIST.DAT 

This example illustrates the typical ADD command and qualifiers. The record 
that results from this command appears in the description of the SHOW 
command. 

2 UAF> ADD WELCH /PASSWORD=SP0158/UIC=[014,051] - 

_/DEVICE=SYS$USER/DIRECTORY=[WELCH]/OWNER="ROB WELCH"/FLAGS=DISUSER - 

_/ACCOUNT=INV/LGICMD=SECUREIN 

%UAF-I-ADDMSG, user record successfully added 

%UAF-I-RDBADDMSGU, identifier WELCH value: [000014,000051] added to 
RIGHTSLIST.DAT 

UAF> MODIFY WELCH/FLAGS=(RESTRICTED,DISNEWMAIL,DISWELCOME,NODISUSER)- 
_/NODIALUP=SECONDARY/NONETWORK=PRIMARY/CLITABLES=DCLTABLES - 
_/NOACCESS=(PRIMARY, 9-16, SECONDARY, 18-8) 

%UAF-I-MDFYMSG, user records updated 

The commands in this example add a record for a restricted account. 

Because of the number of qualifiers required, a MODIFY command is used in 
conjunction with the ADD command. This helps to minimize the possibility of 
typing errors. 

In the ADD command line, setting the DISUSER flag prevents the user 
from logging in until all the account parameters are set up. In the MODIFY 
command line, the DISUSER flag is disabled (by specifying NODISUSER) to 
allow access to the account. 

The record that results from these commands and an explanation of the 
restrictions the record imposes appear in the description of the SHOW 
command. 


ADD/IDENTIFIER 

Adds only an identifier to the rights database. It does not add a user account. 

Format 

ADD/IDENTIFIER [id-name] 

Parameter 


id-name 

Specifies the name of the identifier to be added to the rights database. If you omit 
the name, you must specify the /USER qualifier. The identifier name is a string 
of 1 to 31 alphanumeric characters. The name can contain underscores and dollar 
signs. It must contain at least one nonnumeric character. 
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Qualifiers 

/ATTRIBUTES=(keyword[,...]) 

Specifies attributes to be associated with the new identifier. The following are 
valid keywords: 

Allows unprivileged holders of the identifier to 
remove and to restore the identifier from the 
process rights list by using the DCL command 
SET RIGHTS_LIST. 

Prevents people from getting a list of users who 
hold an identifier, unless they own the identifier 
themselves. 

Allows holders of an identifier to have it 
translated, either from binary to ASCII or from 
ASCII to binary, but prevents unauthorized users 
from translating the identifier. 

Makes any access rights of the identifier null 
and void. If a user is granted an identifier with 
the No Access attribute, that identifier has no 
effect on the user’s access rights to objects. T his 
attribute is a modifier for an identifier with the 
Resource or Subsystem attribute. 

Allows holders of an identifier to charge disk 
space to the identifier. Used only for file objects. 

Allows holders of the identifier to create and 
maintain protected subsystems by assigning the 
Subsystem ACE to the application images in the 
subsystem. Used only for file objects. 

attributes is associated with the new identifier. 

/USER=user-spec 

Scans the UAF record for the specified user and creates the corresponding 
identifier. Specify user-spec by user name or UIC. You can use the asterisk 
wildcard to specify multiple user names or UICs. Full use of the asterisk and 
percent wildcards is permitted for user names; UICs must be in the form [*,*], 
[n,*], [*,n], or [n,n], A wildcard user name specification (*) creates identifiers’ 
alphabetically by user name; a wildcard UIC specification ([*,*]) creates them in 
numerical order by UIC. 

/VALUE=value-specifier 

Specifies the value to be attached to the identifier. The following are valid 
formats for the value-specifier-. 

IDENTIFIERm An integer value in the range of 65,536 to 

268,435,455. You can also specify the value in 
hexadecimal (precede the value with %X) or octal 
(precede the value with %0). 

The system displays this type of identifier in 
hexadecimal. To differentiate general identifiers 
from UIC identifiers, the system adds %X80000000 
to the value you specify. 


DYNAMIC 

HOLDER_HIDDEN 

NAME_HIDDEN 

NOACCESS 

RESOURCE 

SUBSYSTEM 

By default, none of these 
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UIC:uic A UIC value in standard UIC format consists 

of a member name and, optionally, a group 
name enclosed in brackets. For example, 

[GROUP1,JONES] or [360,031]. 

In numeric UICs, the group number is an octal 
number in the range of 1 to 37776; the member 
number is an octal number in the range of 0 to 
177776. You can omit leading zeros when you are 
specifying group and member numbers. 

Regardless of the UIC format you use, the system 
translates a UIC to a 32-bit numeric value. 
Alphanumeric UICs are not allowed. 

Typically, system managers add identifiers as UIC values to represent system 
users; the system applies identifiers in integer format to system resources. 

Examples 

1. UAF> ADD/IDENTIFIER/VALUE=UIC:[300,011] INVENTORY 

%UAF-I-RDBADDMSGU, identifier INVENTORY value: [000300,000011] added to 
RIGHTSLIST.DAT 

The command in this example adds an identifier named INVENTORY to the 
rights database. By default, the identifier is not marked as a resource. 

2. UAF> ADD/IDENTIFIER/ATTRIBUTES=(RESOURCE) - 
_/VALUE=IDENTIFIER:%X80011 PAYROLL 

%UAF-I-RDBADDMSGU, identifier PAYROLL value: %X80080011 added to 
RIGHTSLIST.DAT 

This command adds the identifier PAYROLL and marks it as a resource. To 
differentiate identifiers with integer values from identifiers with UIC values, 
%X80000000 is added to the specified code. 


ADD/PROXY 

Adds an entry to the network proxy authorization file, NETPROXY.DAT or 
NET$PROXY.DAT, and signals DECnet to update its volatile database. Proxy 
additions take effect immediately on all nodes in a cluster that share the proxy 
database. 


Format 

ADD/PROXY node::remote-user local-user[,...] 

Parameters 

node 

Specifies a DECnet node name. If you provide an asterisk (*), the specified 
remote user on all nodes is served by the account defined as local-user . 

remote-user 

Specifies the user name of a user at a remote node. If you specify an asterisk, all 
users at the specified node are served by the local user. 
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For systems that are not OpenVMS and that implement DECnet, specifies the 
UIC of a user at a remote node. You can specify a wildcard asterisk (*) in the 
group and member fields of the UIC. 

local-user 

Specifies the user names of 1 to 16 users on the local node. If you specify an 
asterisk, a local-user name equal to remote-user name will be used. 

Positional Qualifier 

/DEFAULT 

Establishes the specified user name as the default proxy account. The remote 
user can request proxy access to an authorized account other than the default 
proxy account by specifying the name of the proxy account in the access control 
string of the network operation. 

Description 

The ADD/PROXY command adds an entry to the network proxy authorization file, 
NETPROXY.DAT or NET$PROXY.DAT, and signals DECnet to update its volatile 
database. Proxy additions take effect immediately on all nodes in a cluster that 
share the proxy database. 

You can grant a remote user access to one default proxy account and up to 15 
other local accounts. To access proxy accounts other than the default proxy 
account, remote users specify the requested account name in an access control 
string. To change the default proxy account, use the AUTHORIZE command 
MODIFY/PROXY. 

Proxy login is an effective way to avoid specifying (and, possibly, revealing) 
passwords in command lines. However, you must use caution in granting access 
to remote users. While logged in to the local system, remote users can apply the 
full DCL command set (with the exception of SET HOST). A remote user receives 
the default privileges of the local user and, therefore, becomes the owner of the 
local user’s files when executing any DCL commands. 

To avoid potential security compromises, Digital recommends that you create 
proxy accounts on the local node that are less privileged than a user’s normal 
account on the remote node. By adding an extension such as _N, you can identify 
the account as belonging to a remote user, while distinguishing it from a native 
account with the same name on the local node. For example, the following 
command creates a JONES_N proxy account on the local node that allows the 
user JONES to access the account from the remote node SAMP LE - 

UAF> ADD/PROXY SAMPLE::JONES J0NES_N/DEFAULT 

%UAF-I-NAFADDMSG, record successfully added to NETPROXY.DAT 

For more information on creating proxy accounts, see the OpenVMS Guide to 
System Security. 

Examples 

1. UAF> ADD/PROXY SAMPLE::WALTER ROBIN/DEFAULT 

%UAF-I-NAFADDMSG, record successfully added to NETPROXY.DAT 

Specifies that user WALTER on remote node SAMPLE has proxy access to 
user ROBIN’s account on local node AXEL. Through proxy login, WAT,TER 
receives the default privileges of user ROBIN when he accesses node AXEL 
remotely. 


5-23 











AUTHORIZE 

ADD/PROXY 


2. UAF> ADD/PROXY MISHA::* MARCO/DEFAULT, OSCAR 

%UAF-I-NAFADDMSG, record successfully added to NETPROXY.DAT 

Specifies that any user on the remote node MISHA can, by default, use the 
MARCO account on the local node for DECnet tasks such as remote file 
access. Remote users can also access the OSCAR proxy account by specifying 
the user name OSCAR in the access control string. 

3. UAF> ADD/PROXY MISHA::MARCO */DEFAULT 

%UAF-I-NAFADDMSG, record successfully added to NETPROXY.DAT 

Specifies that user MARCO on the remote node MISHA can use only the 
MARCO account on the local node for remote file access. 

4. UAF> ADD/PROXY TAO::MARTIN MARTIN/D,SALES_READER 

%UAF-I-NAFADDMSG, proxy from TAO:.TWA.RAN::MARTIN to MARTIN added 
%UAF-I-NAFADDMSG, proxy from TAO:.TWA.RAN::MARTIN to SALES_READER added 

Adds a proxy from TAO::MARTIN to the local accounts MARTIN (the default) 
and SALES_READER on a system running DECnet/OSI. 


COPY 

Creates a new SYSUAF record that duplicates an existing UAF record. 

Format 

COPY oldusername newusername 

Parameters 

oldusername 

Name of an existing user record to serve as a template for the new record. 

newusername 

Name for the new user record. The user name is a string of 1 to 12 alphanumeric 
characters. 

Qualifiers 

All the qualifiers listed under the ADD command apply to the COPY command. 

Description 

The COPY command creates a new SYSUAF record that duplicates an existing 
SYSUAF record. The command requires the /PASSWORD qualifier. If you do not 
specify additional qualifiers to the COPY command, the fields in the record you 
create are the same as those in the record being copied. 

When the new account is created, AUTHORIZE sets the salt value associated 
with a new user’s account password to a random value. 

For example, you could add a record for a new user named Thomas Sparrow that 
is identical to that of Joseph Robin (but presumably different from the default 
record), as follows: 

UAF> COPY ROBIN SPARROW /PASSWORD=SP0152 
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However, to add a record for Thomas Sparrow that differs from Joseph Robin’s in 
the UIC, directory name, password, and owner, specify the following command: 

UAF> COPY ROBIN SPARROW /UIC=[200,13]/DIRECTORY=[SPARROW] - 
_/PASSWORD=THOMAS/OWNER="THOMAS SPARROW" 

You can also use the COPY command to create a set of template records to meet 
the specific needs of various user groups. For example, if you have programmers, 
administrators, and data entry personnel working on the same system, you can 
create records such as PROGRAMMER, ADMINISTRATOR, and DATA.ENTRY, 
each tailored to the needs of a particular group. To add an account for a new user 
in one of these groups, copy the appropriate template record and specify a new 
user name, password, UIC, directory, and owner. 

If you omit the /PASSWORD qualifier when you create an account, AUTHORIZE 
displays the following error message: 

%UAF-W-DEFPWD, copied or renamed records must receive new password 

To specify a password for the account, use the MODIFY command with the 
/PASSWORD qualifier. 

Examples 

1. UAF> COPY ROBIN SPARROW /PASSWORD=SP0152 
%UAF-I-COPMSG, user record copied 

%UAF-E-RDBADDERRU, unable to add SPARROW value: [000014,00006] to 
RIGHTSLIST.DAT -SYSTEM-F-DUPIDENT, duplicate identifier 

The command in this example adds a record for Thomas Sparrow that is 
identical, except for the password, to that of Joseph Robin. Note that because 
the UIC value has no change, no identifier is added to RIGHTSLIST.DAT. 
AUTHORIZE issues a “duplicate identifier” error message. 

2. UAF> COPY ROBIN SPARROW /UIC=[200,13]/DIRECTORY=[SPARROW] - 
_/PASSWORD=THOMAS/OWNER="THOMAS SPARROW" 

%UAF-I-COPMSG, user record copied 

%UAF-I-RDBADDMSGU, identifier SPARROW value: [000200,000013] added to 
RIGHTSLIST.DAT 

The command in this example adds a record for Thomas Sparrow that is the 
same as Joseph Robin’s except for the UIC, directory name, password, and 
owner. Note that you could use a similar command to copy a template record 
when adding a record for a new user in a particular user group. 


CREATE/PROXY 


4^!4 


Creates and initializes the network proxy authorization file 
NETPROXY.DAT. 

On VAX systems, the primary network proxy authorization file is 
NET$PROXY.DAT. The file NETPROXY.DAT is maintained for compatibility. 

-Note __ 

Do not delete NETPROXY.DAT because DECnet Phase IV and many 
layered products still use it. ♦ 
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Format 

CREATE/PROXY 


Parameters 

None. 

Qualifiers 

None. 

Description 

NETPROXY.DAT is created with no records and is assigned the following 


m?f$m 

protection: 

(S:RWED,0:RWED,G,W) 

On VAX systems, NET$PROXY.DAT is also created with no records and is 
assigned the following protection: 

(S:RWED,0,G,W) ♦ 

If NETPROXY.DAT or NET$PROXY.DAT already exist, AUTHORIZE reports the 
following error message: 

%UAF-W-NAFAEX, NETPROXY.DAT already exists 

To create a new file, you must either delete or rename the old one. 

Example 

UAF> CREATE/PROXY 

UAF> 

The command in this example creates and initializes the network proxy 
authorization file. 


CREATE/RIGHTS 


Format 

Creates and initializes the rights database, RIGHTSLIST.DAT. 

CREATE/RIGHTS 


Parameters 

None. 

Qualifiers 

None. 
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Description 

RIGHTSLIST.DAT is created with no records and is assigned the following 
protection: 

(S:RWED,0:RWED,G:R, W:) 

Note that the file is created only if the file does not already exist. 

Example 

UAF> CREATE/RIGHTS 

%UAF-E-RDBCREERR, unable to create RIGHTSLIST.DAT 
-RMS-E-FEX, file already exists, not superseded 

You can use the command in this example to create and initialize a new rights 
database. Note, however, that RIGHTSLIST.DAT is created automatically during 
the installation process. Thus, you must delete or rename the existing file before 
creating a new one. For more information on rights database management, refer 
to the OpenVMS Guide to System Security. 


DEFAULT 

Modifies the SYSUAF’S DEFAULT record. 

Format 

DEFAULT 

Parameters 

None. 

Qualifiers 


See the qualifiers listed under the ADD command. 

Description 

Modify the DEFAULT record when qualifiers normally assigned to a new user 
differ from the Digital-supplied values. The following qualifiers most often 
require modification: 

• /CLI—If the command interpreter is MCR. 

• /DEVICE—If most users have the same default device. 

• /LGICMD—When automation of initial housekeeping chores at login time 
is desired through a specific login command file. The system automates the 
execution of login command file in the following way: 

First the system checks whether the logical name SYS$SYLOGIN has been 
defined. If it has, the name is translated (in most cases to SYLOGIN.COM), 
and the named command file is executed. (This command file can call other 
login command files.) However, when it completes, the system makes another 
check. If the user’s LGICMD field in the UAF specifies a command file, that 
file is executed. If LGICMD is blank, the user’s file LOGIN.COM is executed 
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automatically if the command interpreter is DCL. (In this case, all users must 
name their login command files LOGIN.COM.) If the command interpreter is 
MCR, the user’s file LOGIN.CMD is executed automatically. 

Thus, the login protocol generally consists of a systemwide login command file 
followed by a user-specific login command file. 

• /PRIVILEGES—When users are given different privileges than those supplied 
by Digital. 

• Quota qualifiers—When the default quotas are insufficient or inappropriate 
for mainstream work. 

Example 

UAF> DEFAULT /DEVICE=SYS$USER/LGICMD=SYS$MANAGER: SECURELGN - 
_UAF> /PRIVILEGES=(TMPMBX,GRPNAM,GROUP) 

%UAF-I-MDFYMSG, user record(s) updated 

The command in this example modifies the DEFAULT record, changing the 
default device, default login command file, and default privileges. 


EXIT 

Enables you to exit from AUTHORIZE and return to DCL command level. You 
can also return to command level by pressing Ctrl/Z. 

Format 

EXIT 

Parameters 

None. 

Qualifiers 

None. 


GRANT/IDENTIFIER 

Assigns the specified identifier to the user and documents the user as a holder of 
the identifier in the rights database. 

Format 

GRANT/IDENTIFIER id-name user-spec 

Parameters 

id-name 

Specifies the identifier name. The identifier name is a string of 1 to 31 
alphanumeric characters that can contain underscores and dollar signs. The 
name must contain at least one nonnumeric character. 
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user-spec 

Specifies the UIC identifier that uniquely identifies the user on the system. 
This type of identifier appears in alphanumeric format. For example - 
[GROUP1,JONES]. 

Qualifier 


Example 


/ATTRIBUTES=(keyword[,...]) 

Specifies attributes to be associated with the identifier. The following are valid 
keywords: 


DYNAMIC 

HOLDER_HIDDEN 

NAME.HIDDEN 

NOACCESS 

RESOURCE 

SUBSYSTEM 


Allows unprivileged holders of the identifier to 
remove and to restore the identifier from the 
process rights list by using the DCL command 
SET RIGHTS_LIST. 

Prevents people from getting a list of users who 
hold an identifier, unless they own the identifier 
themselves. 

Allows holders of an identifier to have it 
translated, either from binary to ASCII or from 
ASCII to binary, but prevents unauthorized users 
from translating the identifier. 

Makes any access rights of the identifier null 
and void. If a user is granted an identifier with 
the No Access attribute, that identifier has no 
effect on the user’s access rights to objects. This 
attribute is a modifier for an identifier with the 
Resource or Subsystem attribute. 

Allows holders of an identifier to charge disk 
space to the identifier. Used only for file objects. 

Allows holders of the identifier to create and 
maintain protected subsystems by assigning the 
Subsystem ACE to the application images in the 
subsystem. Used only for file objects. 


To remove an attribute from the identifier, add a NO prefix to the 
attribute keyword. For example, to remove the Resource attribute, specify 
/ATTRIBUTES=N ORESOURCE. 


UAF> GRANT/IDENTIFIER INVENTORY [300,015] 

%UAF-I-GRANTMSG, identifier INVENTORY granted to CRAMER 

The command in this example grants the identifier INVENTORY to the user 
named Cramer who has UIC [300,015], Cramer becomes the holder of the 
identifier and any resources associated with it. The following command produces 
the same result: 

UAF> GRANT/IDENTIFIER INVENTORY CRAMER 
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HELP 


Displays information concerning the use of AUTHORIZE, including formats and 
explanations of commands, parameters, and qualifiers. 

Format 

HELP [keyword[,...] 

Parameter 

keyword[,...] , ... 

Specifies one or more keywords that refer to the topic, command, qualiher, 
or parameter on which you want information from the AUTHORIZE HELP 
command. 

Qualifiers 

None. 

Description 

If you do not specify a keyword, HELP displays information on the topics and 
commands for which help is available. It then prompts you with Topic? . You 
can supply a topic or a command name, or press Return. When you specify a 
command name and qualifiers, you get detailed information about that command. 
If you respond by pressing Return, you exit from help. You can also exit from 
help by pressing Ctrl/Z. 

If the command you request accepts qualifiers, the display of the help information 
on the command is followed by the prompt “Subtopic?”. Respond to this prompt 
with a qualifier name, or press Return. If you respond by pressing Return, HELP 
prompts with “Topic?”. If you want to exit from help directly from this level, press 
Ctrl/Z. 

Examples 

1. UAF> HELP ADD 

The HELP command in this example displays information about the ADD 
command: 

ADD 

Adds a user record to the SYSUAF and corresponding identifiers to 
the rights database. 

Format 

ADD newusername 

Additional information available: 
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Parameter Qualifiers 

/ACCESS /ACCOUNT 

/BIOLM /BYTLM 

/DEVICE /DIALUP 

/FILLM /FLAGS 

/LGICMD /LOCAL 

/MODIFY_IDENTIFIER 
/PRIMEDAYS /PRIORITY 
/PWDLIFETIME 
/UIC /WSDEFAULT 

Examples /IDENTIFIER 

ADD Subtopic? 


/ADD_IDENTIFIER 
/CLI /CLITABLES 

/DIOLM /DIRECTORY 

/ GENERATE_PAS SWORD 
/MAXACCTJOBS 
/NETWORK /OWNER 
/PRIVILEGES 
/PWDMINIMUM 
/WSEXTENT /WSQUOTA 
/PROXY 


/ALGORITHM /ASTLM /BATCH 

/CPUTIME /DEFPRIVILEGES 
/ENQLM /EXPIRATION 

/INTERACTIVE /JTQUOTA 

/MAXDETACH /MAXJOBS 
/PASSWORD /PGFLQUOTA /PRCLM 
/PWDEXPIRED 

/REMOTE /SHRFILLM /TQELM 


2. UAF> HELP MODIFY/WSDEFAULT 

The command in this example displays information about the /WSDEFAULT 
qualifier: 

MODIFY 

/WSDEFAULT=value 

Specifies the default working set size. This represents the 

initial limit to the number of physical pages the process can 

use. (The user can alter the default quantity up to WSQUOTA with 

the DCL command SET WORKING_SET.) The minimum value is 50 pages 

(on VAX systems) and 150 pagelets (on Alpha systems). By default, a user 

has 150 pages (on VAX systems) and 150 pagelets (on Alpha systems). 


LIST 

Writes reports for selected UAF records to a listing file, SYSUAF.LIS. 

Format 

LIST [user-spec] 

Parameter 

user-spec 

Specifies the user name or UIC of the requested UAF record. Without the user- 
spec parameter, AUTHORIZE lists the user records of all users. The asterisk and 
percent sign wildcards are permitted in the user name. 

Qualifiers 

/BRIEF 

Specifies that a brief report be written to SYSUAF.LIS. The /BRIEF qualifier is 
the default qualifier. 

/FULL 

Specifies that a full report be written to SYSUAF.LIS, including identifiers held 
by the user. 
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Description 

The LIST command creates a listing file of reports for selected UAF records. 

Print the listing file, SYSUAF.LIS, with the DCL command PRINT. 

Specification of a user name results in a single-user report. Specification of the 
asterisk wildcard character following the LIST command results in reports tor 
all users in ascending sequence by user name. Specification of a UIC results in 
reports for all users with that UIC. (Digital recommends that you assign each 
user a unique UIC, but if users share a UIC, the report will show all users with 
that UIC.) You can use the asterisk wildcard character to specify the UIC. 

Table 5-2 shows how to specify a UIC with the LIST command and use the 
asterisk wildcard character with the UIC specification to produce various types of 
reports. 


Table 5-2 UIC Specification with the LIST Command 


Command 

Description 

LIST [14,6] 

Lists a full report for the user (or users) with 

member number 6 in group 14. 

LIST [14,*] /BRIEF 

Lists a brief report for all users in group 14, in 
ascending sequence by member number. 

LIST [*,6] /BRIEF 

Lists a brief report for all users with a member 
number of 6. 

LIST [*,*] /BRIEF 

Lists a brief report for all users, in ascending 
sequence by UIC. 


Although you must provide separate UICs for each user, the LIST command 
reports users with the same UIC in the order in which they were added to the 
SYSUAF. Full reports list the details of the limits, privileges, login flags, and 
command interpreter. Brief reports do not include the limits, login flags, or 
command interpreter, nor do they summarize the privileges. AUTHORIZE never 
displays the password for an account. 

See the SHOW command for examples of brief and full reports. 


Examples 

1. UAF> LIST ROBIN/FULL 
%UAF-I-LSTMSG1, writing listing file 
%UAF-I-LSTMSG2, listing file SYSUAF.LIS complete 

This command lists a full report for the user record ROBIN. 

2. UAF> LIST * 

%UAF-I-LSTMSG1, writing listing file 
%UAF-I-LSTMSG2, listing file SYSUAF.LIS complete 

This command results in brief reports for all users in ascending sequence by 
user name. Note, however, that this is the same result you would produce 
had you omitted the asterisk wildcard. 
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3. UAF> LIST [300.*] 

%UAF-I-LSTMSG1, writing listing file 
%UAF-I-LSTMSG2, listing file SYSUAF.LIS complete 

This command lists a brief report for all user records with a group UIC of 


LIST/IDENTIFIER 


Creates a listing file (RIGHTSLIST.LIS) in which identifier names, attributes, 
values, and holders are written. 

Format 

LIST/IDENTIFIER [id-name] 

Parameter 

id-name 

Specifies an identifier name. You can specify the asterisk wildcard character (*) 
to list all identifiers. If you omit the identifier name, you must specify /USER or 
/VALUE. 

Qualifiers 

/BRIEF 

Specifies a brief listing in which only the identifier name, value and attributes 
appear. 


/FULL 

Specifies a full listing, in which the names of the identifier’s holders are displayed 
along with the identifier’s name, value, and attributes. The /FULL qualifier 
specifies the default listing format. 

/USER=user-spec 

Specifies one or more users whose identifiers are to be listed. User-spec can 
be a user name or UIC. You can use the asterisk wildcard to specify multiple 
user names or UICs. UICs must be in the form [*,*], [n,*], [*,n], or [n,n], A 
wildcard user name specification (*) lists identifiers alphabetically by user name; 
a wildcard UIC specification ([*,*]) lists them numerically by UIC. 

/VALUE=value-specifier 

Specifies the value of the identifier to be listed. The following are valid formats 
for the value-specifier: 

An integer value in the range 65,536 to 268,435,455. 
You can also specify the value in hexadecimal 
(precede the value with %X) or octal (precede the 
value with %0). 

To differentiate general identifiers from UIC 
identifiers, %X80000000 is added to the value 
you specify. 

A UIC value in the standard UIC format. 


IDENTIFIER:n 


UIC:uic 
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Description 

The LIST/IDENTIFIER command creates a listing file in which identifier names, 
attributes, values, and holders are displayed in various formats depending on the 
qualifiers specified. Two of these formats are illustrated in the description of the 
SHOW/IDENTIFIER command. 

Print the listing file named RIGHTSLIST.LIS with the DCL command PRINT. 

Examples 

1. UAF> LIST/IDENTIFIER INVENTORY 
%UAF-I-LSTMSG1, writing listing file 
%UAF-I-RLSTMSG, listing file RIGHTSLIST.LIS complete 

The command in this example generates a full listing for the identifier 
INVENTORY, including its value (in hexadecimal), holders, and attributes. 

2. UAF> LIST/IDENTIFIER/USER=ANDERSON 
%UAF-I-LSTMSG1, writing listing file 
%UAF-I-RLSTMSG, listing file RIGHTSLIST.LIS complete 

This command lists an identifier associated with the user ANDERSON, along 
with its value and attributes. Note, however, that this is the same result you 
would produce had you specified ANDERSON’s UIC with the following forms 
of the command: 

UAF> LIST/IDENTIFIER/USER=[300,015] 

UAF> LIST/IDENTIFIER/VALUE=UIC:[300,015] 


LIST/PROXY 

Creates a listing file of the network proxy database entries. 


Format 

LIST/PROXY 

Parameters 

None. 


Qualifiers 



/OLD . 

On VAX systems, directs AUTHORIZE to display information from 
NETPROXY.DAT rather than the default file NET$PROXY.DAT. 

If someone modifies the proxy database on a cluster node that is not running the 
current OpenVMS VAX system, then you can use the /OLD qualifier to list the 
contents of the old database: NETPROXY.DAT. ♦ 
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Description 

Use the DCL command PRINT to print the listing file, NETPROXY.LIS. The 
output assumes the same format as that of the SHOW/PROXY command. For an 
example of the output format, see the description of the SHOW/PROXY command. 

Example 

UAF> LIST/PROXY 

%UAF-I-LSTMSG1, writing listing file 

%UAF-I-NETLSTMSG, listing file NETPROXY.LIS complete 

The command in this example creates a listing file of all the entries in the 
network proxy database. 


LIST/RIGHTS 


Lists identifiers held by the specified identifier or, if /USER is specified, all 
identifiers held by the specified users. 

Format 

LIST/RIGHTS [id-name] 

Parameter 

id-name 

Specifies the name of the identifier associated with the user. If you omit the 
identifier name, you must specify the /USER qualifier. 

Qualifier 

/USER=user-spec 

Specifies a user whose identifiers are to be listed. User-spec can be a user nam e 
or UIC. You can use the asterisk wildcard to specify multiple UICs or all user 
names. UICs must be in the form [*,*], [n,*], [*,n], or [n,n]. A wildcard user 
name specification (*) or wildcard UIC specification ([*,*]) lists all identifiers 
held by users. The wildcard user name specification lists holders’ user names 
alphabetically; the wildcard UIC specification lists them in the numerical order of 
their UICs. 

Description 

Use the DCL command PRINT to print the listing file (RIGHTSLIST.LIS) 
produced by the LIST/RIGHTS command. For an example of the output format, 
see the description of the SHOW/RIGHTS command. 

Example 

UAF> LIST/RIGHTS PAYROLL 

%UAF-I-LSTMSG1, writing listing file 

%UAF-I-RLSTMSG, listing file RIGHTSLIST.LIS complete 

The command in this example lists identifiers held by PAYROLL, providing 
PAYROLL is the name of a UIC format identifier. 


5—35 









AUTHORIZE 

MODIFY 


MODIFY 

Changes values in a SYSUAF user record. Qualifiers not specified in the 
command remain unchanged. 

Format 

MODIFY username /qualifier^...] 

Parameter 

username 

Specifies the name of a user in the SYSUAF. The asterisk and percent sign 
wild card characters are permitted in the user name. When you specify a single 
asterisk for the user name, you modify the records of all users. 

Qualifiers 

/MODIFY-IDENTIFIER (default) 

/NOMODIFYJDENTIFIER 

Specifies whether the identifier associated with the user is to be modified in the 
rights database. This qualifier applies only when you modify the UIC or user 
name in the UAF record. By default, the associated identifiers are modified. 


See also the qualifiers listed under the ADD command. 

Description 

The MODIFY command changes values in a SYSUAF user record. Most values 
not in the command remain unchanged. If the UIC is changed, the value of the 
corresponding identifier is also changed. 

Modifications to the user record are not retroactive; thus, any changes to quota 
values apply to the next process that is created but not to the current one. 

Examples 

1. UAF> MODIFY ROBIN /PASSWORD=SP0172 
%UAF-I-MDFYMSG, user record(s) updated 

The command in this example changes the password for user ROBIN without 
altering any other values in the record. 

2. UAF> MODIFY ROBIN/FLAGS=RESTRICTED 
%UAF-I-MDFYMSG, user record(s) updated 

The command in this example modifies the UAF record for user ROBIN by 
adding the login flag RESTRICTED. 
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MODIFY/IDENTIFIER 

Modifies an identifier name, its associated value, or its attributes in the rights 
database. 


Format 

MODIFY/IDENTIFIER id-name 

Parameter 

id-name 

Specifies the name of an identifier to be modified. 


Qualifiers 

/ATTRIBUTES=(keyword[,...]) 

Specifies attributes to be associated with the modified identifier. The following 
are valid keywords: 


DYNAMIC 


Allows unprivileged holders of the identifier to 
remove and to restore the identifier from the 
process rights list by using the DCL command 
SET RIGHTS_LIST. 


HOLDER_HIDDEN 

NAME.HIDDEN 


NOACCESS 


Prevents people from getting a list of users who 
hold an identifier, unless they own the identifier 
themselves. 

Allows holders of an identifier to have it 
translated, either from binary to ASCII or from 
ASCII to binary, but prevents unauthorized users 
from translating the identifier. 

Makes any access rights of the identifier null 
and void. If a user is granted an identifier with 
the No Access attribute, that identifier has no 
effect on the user’s access rights to objects. This 
attribute is a modifier for an identifier with the 
Resource or Subsystem attribute. 


RESOURCE 

SUBSYSTEM 


Allows holders of an identifier to charge disk 
space to the identifier. Used only for file objects. 
Allows holders of the identifier to create and 
maintain protected subsystems by assigning the 
Subsystem ACE to the application images in the 
subsystem. Used only for file objects. 


To remove an attribute from the identifier, add a NO prefix to the 
attribute keyword. For example, to remove the Resource attribute, specify 
/ATTRIBUTES=NORESOURCE. 


-Note_ 

If you specify the NORESOURCE keyword without naming any holder 
with the /HOLDER qualifier, all holders lose the right to charge resources. 
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/HOLDER=username 

Specifies the holder of an identifier whose attributes are to be modified, the 
/HOLDER qualifier is used only in conjunction with the /ATTRIBUTES qualifier. 

If you specify /HOLDER, the /NAME and /VALUE qualifiers are ignored. 

/NAME=new-id-name 

Specifies a new identifier name to be associated with the identifier. 

/VALU E=val ue-specif ier 

Specifies a new identifier value. Note that an identifier value cannot be modified 
from a UIC to a non-UIC format or vice versa. The following are valid formats for 
the value-specifier: 

IDENTIFIER:n An integer value in the range of 65,536 to 

268,435,455. You can also specify the value in 
hexadecimal (precede the value with %X) or octal 
(precede the value with %0). 

To differentiate general identifiers from UIC 
identifiers, %X80000000 is added to the value 
you specify. 

UIC:uic A UIC value in the standard UIC format. 

Description 

The MODIFY/IDENTIFIER command changes identifier names, associated 
values, and attributes in the rights database. Values not specified in the 
command remain unchanged. 

Examples 

1. UAF> MODIFY/IDENTIFIER 0LD_ID /NAME=NEW_ID. 

%UAF-I-RDBMDFYMSG, identifier 0LD_ID modified 

The command in this example changes the name of the OLD_ID identifier to 
NEWJD. 

2. UAF> MODIFY/IDENTIFIER/VALUE=UIC:[300,21] ACCOUNTING 
%UAF-I-RDBMDFYMSG, identifier ACCOUNTING modified 

The command in this example changes the old UIC value of the identifier 
ACCOUNTING to a new value. 

3. UAF> MODIFY/IDENTIFIER/ATTRIBUTES=NORESOURCE- 

_UAF> /HOLDER=CRAMER ACCOUNTING 

%UAF-I-RDBMDFYMSG, identifier ACCOUNTING modified 

The command in this example associates the attribute NORESOURCE with 
the identifier ACCOUNTING in CRAMER’s holder record. The identifier 
ACCOUNTING is not changed. 
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MODIFY/PROXY 


Modifies an entry in the network proxy authorization file NETPROXY.DAT to 
specify a different local account as the default proxy account for the remote user 
or to specify no default proxy account for the remote user. 

On VAX systems, modifies an entry in the network proxy authorization file 
NET$PROXY.DAT and, to maintain compatibility with other systems, modifies an 
entry in NETPROXY.DAT. 

-—_ Note __ 

You must modify the proxy database from a system running the current 
OpenVMS VAX system. ♦ 


Format 

MODIFY/PROXY node::remote-user 

Parameters 

node 

Specifies a node name. If you specify an asterisk (*), the specified remote user on 
all nodes is served by the local user. 

remote-user 

Specifies the user name of a user at a remote node. If you specify an asterisk, all 
users at the specified node are served by the local user. 

For systems that are not OpenVMS systems that implement DECnet, specifies 
the UIC of a user at a remote node. You can specify a wildcard asterisk in the 
group and member fields of the UIC. 

Qualifier 

/DEFAULT[=local-user] 

/NODEFAULT 

Designates the default user name on the local node through which proxy access 
from the remote user is directed. If /NODEFAULT is specified, removes the 
default designation. 

Description 

Use the MODIFY/PROXY command to specify a different local account as 
the default proxy account for the remote user or to specify that there is no 
default proxy account for the remote user. Whenever you modify user entries, 
AUTHORIZE signals DECnet to update its volatile database. Proxy modifications 
take effect immediately on all nodes in a cluster that share the proxy database. 

The first command in the following example grants remote user STIR::YETTA 
proxy access to the PROXY1 and PROXY2 local accounts. The default proxy 
account is PROXY1. The second command is used to change the default proxy 
account to PROXY2. 
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UAF> ADD/PROXY STIR::YETTA PROXY1/DEFAULT, PROXY2 

UAF> MODIFY/PROXY STIR::YETTA /DEFAULT=PROXY2 

The next example shows the command used to remove the default proxy 
designation. 

UAF> MODIFY/PROXY STIR::YETTA /NODEFAULT 

If you remove the default proxy designation as shown in the last command, 
remote user STIR::YETTA must include the name of the proxy account (PROXY1 
or PROXY2) in the access control string of each network operation to gain proxy 
access to the local system. 

If no default proxy account is specified either in the network proxy database or in 
the access control string of the DCL command, the system attempts to perform 
the network operation using the default DECnet account. 

Example 

UAF> MODIFY/PROXY MISHA::MARC0 /DEFAULT=JOHNSON 

%UAF-I-NAFADDMSG, record successfully modified in NETPROXY.DAT 

The command in this example changes the default proxy account for user MARCO 
on the remote node MISHA to the JOHNSON account. 


MODIFY/SYSTEM_PASSWORD 

Changes the system password in the same manner as the DCL command SET 
PASSWORD/SYSTEM. 

Format 

MODIFY/SYSTEM_PASSWORD=system-password 

Parameter 

system-password 

Specifies the new system password. 

Qualifiers 

None. 

Description 

For a detailed description of the effects of this command, refer to the discussion 
of the SET PASSWORD/SYSTEM command in the OpenVMS Guide to System 
Security. 

Example 

UAF> MODIFY/SYSTEM_PASSWORD=ABRACADABRA 
UAF> 

This command changes the system password to ABRACADABRA. 
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REMOVE 

Deletes a SYSUAF user record and corresponding identifiers in the rights 
database. The DEFAULT and SYSTEM records cannot be deleted. 

Format 

REMOVE username 

Parameter 

username 

Specifies the name of a user in the SYSUAF. 

Qualifier 

/REMOVEJDENTIFIER (default) 

/NOREMOVE JDENTIFIER 

Specifies whether the user name and account name identifiers should be removed 
from the rights database when a record is removed from the UAF. If two UAF 
records have the same UIC, the user name identifier is removed only when the 
second record is deleted. Similarly, the account name identifier is removed only if 
there are no remaining UAF records with the same group as the deleted record. 

Description 

If you remove a SYSUAF record for a user who also appears as a local user in the 
network user authorization file, every network authorization record for that user 
is also removed. 


Example 

UAF> REMOVE ROBIN 

%UAF-I-REMMSG, record removed from SYSUAF.DAT 

%UAF-I-RDBREMMSGU, identifier ROBIN value: [000014,000006] removed from 
RIGHTSLIST.DAT 

The command in this example deletes the record for user ROBIN from the 
SYSUAF and ROBIN’s UIC identifier from RIGHTSLIST.DAT. 


REMOVE/IDENTIFIER 


Format 


Removes an identifier from the rights database. 


REMOVE/IDENTIFIER id-name 


Parameter 


id-name 

Specifies the name of an identifier in the rights database. 
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Qualifiers 

None. 

Example 

UAF> REMOVE/IDENTIFIER Q1SALES 

%UAF-I-RDBREMMSGU, identifier Q1SALES value %X80010024 removed from 
RIGHTSLIST. DAT 

The command in this example removes the identifier Q1SALES from the rights 
database. All of its holder records are removed with it. 

REMOVE/PROXY 

Deletes network proxy access for the specified remote user. 


Format 

REMOVE/PROXY node::remote-user [local-user,...] 

Parameters 

node 

Specifies the name of a network node in the network proxy authorization file. 

remote-user 

Specifies the user name or UIC of a user on a remote node. The asterisk wildcard 
character is permitted in the remote-user specification. 

local-user 

Specifies the user name of from 1 to 16 users on the local node. If no local user is 
specified, proxy access to all local accounts is removed. 

Qualifiers 

None. 

Example 

UAF> REMOVE/PROXY MISHA::MARCO 

%UAF-I-NAFREMMSG, proxy from MISHA::MARCO to * removed 

The command in this example deletes the record for MISHA: :MARCO from the 
network proxy authorization file, removing all proxy access to the local node for 
user MARCO on node MISHA. 
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RENAME 


Changes the user name of the SYSUAF record (and, if specified, the 
corresponding identifier) while retaining the characteristics of the old record. 

Format 


RENAME oldusername newusername 

Parameters 

oldusername 

Specifies the current user name in the SYSUAF. 


newusername 


Specifies the new name for the user. It can contain 1 to 12 alphanumeric 
characters and underscores. Although dollar signs are permitted, they are 
usually reserved for system names. 


Qualifiers 


/GENERATE_PASSWORD[=keyword] 

/NOGENERATE_PASSWORD (default) 

Invokes the password generator to create user passwords. Generated passwords 
can consist of 1 to 10 characters. Specify one of the following keywords: 


BOTH 

CURRENT 


Generate primary and secondary passwords. 

Do whatever the DEFAULT account does (for example, 
generate primary, secondary, both, or no passwords). This 
is the default keyword. 


PRIMARY Generate primary password only. 

SECONDARY Generate secondary password only. 


When you modify a password, the new password expires automatically; it is 
valid only once (unless you specify /NOPWDEXPIRED). On login, users are 
forced to change their passwords (unless you specify /FLAGS=DISFORCE_PWD 


Note that the /GENERATE_PASSWORD and /PASSWORD qualifiers are 
mutually exclusive. 


/MODIFYJDENTIFIER (default) 

/NOMODIFYJDENTIFIER 

Specifies whether the identifier associated with the user is to be modified in the 
rights database. This qualifier applies only when you modify the UIC or user 
name in the UAF record. By default, the associated identifiers are modified. 


/PASSWORD=(password1[,password21) 

/NOPASSWORD 

Specifies up to two passwords for login. Passwords can be from 0 to 32 characters 
m length and can include alphanumeric characters, dollar signs, and underscores. 
Avoid using the word password as the actual password. Use the /PASSWORD 
qualifier as follows: 

• To set only the first password and clear the second, specify 
/PASSWORD=password. 
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Description 


Examples 


• To set both the first and second password, specify /PASSWORD-(passwordl, 
password2). 

• To change the first password without affecting the second, specify 
/PASSWORD=(password, 

• To change the second password without affecting the first, specify 
/PASSWORD^"", password). 


• To set both passwords to null, specify /NOPASSWORD. 

When you modify a password, the new password expires automatically; it is valid 
only once (unless you specify /NOPWDEXPIRED). On login, the user is forced to 
change thepassword (unless you specify /FLAGS=DISFORCE_PWD_CHANGE). 

Note that the /GENERATE_PASSWORD and /PASSWORD qualifiers are 
mutually exclusive. 


When you create a new UAF record with the RENAME command, you must 
specify a password. 


The RENAME command renames a SYSUAF record. It changes the user name of 
the SYSUAF record (and, if specified, the corresponding identifier) while retaining 
the characteristics of the old record. Retention of these characteristics can be 
particularly helpful when a user s name changes. 

Note that because password verification includes the user name as well as the 
password, an attempted login will fail when the user whose name has been 
changed attempts to log in with an old password. (Only null passwords can 
be effectively transferred from one user record to another by the RENAME 
command.) Make it a practice to include a new password when you use 
the RENAME command, and notify the user of the change. If you omit the 
/PASSWORD qualifier, you receive a warning message reminding you that the old 
password must be changed. 

The user’s network authorization records are automatically changed to the new 
name. 


1 UAF> RENAME HAWKES KRAMERDOVE/PASSWORD=MARANNKRA 
%UAF-I-PRACREN ; proxies to HAWKES renamed 
%UAF-I-RENMSG, user record renamed 
%UAF-I-RDBMDFYMSG, identifier HAWKES modified 

The command in this example changes the name of the account Hawkes to 
Kramerdove, modifies the user name identifier for the account, and renames 
all proxies to the account. 

2. UAF> RENAME HAWKES KRAMERDOVE 

%UAF-I-PRACREN, proxies to HAWKES renamed 
%UAF-I-RENMSG, user record renamed 

%UAF-W-DEFPWD, Warning: copied or renamed records must receive 

new password t , 

%UAF-I-RDBMDFYMSG, identifier HAWKES modified 

This example shows the warning message that the system displays if you fail 
to specify a new password with the RENAME command. 
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RENAME/IDENTIFIER 

Renames an identifier in the rights database. 


Format 

RENAME/IDENTIFIER current-id-name new-id-name 

Parameters 

current-id-name 

Specifies the name of an identifier to be renamed. 

new-id-name 

Specifies the new name for the identifier. 

Qualifiers 

None. 

Description 

The RENAME/IDENTIFIER command is functionally equivalent to the following 
AUTHORIZE command: 

MODIFY/IDENTIFIER/NAME=new-id-name current-id-name 

Example 

UAF> RENAME/IDENTIFIER Q1SALES Q2SALES 

%UAF-I-RDBMDFYMSG, identifier Q1SALES modified 

The command in this example renames the identifier Q1SALES to Q2SALES. 

REVOKE/IDENTIFIER 

Takes an identifier away from a user. 

Format 

* REVOKE/IDENTIFIER id-name user-spec 

Parameters 

id-name 

Specifies the identifier name. The identifier name is a string of 1 to 31 
alphanumeric characters. The name can contain underscores and dollar signs. It 
must contain at least one nonnumeric character. 

user-spec 

Specifies the UIC identifier that uniquely identifies the user on the system. 

This type of identifier appears in alphanumeric format, not numeric format- for 
example, [GROUP1,JONES], 
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Description 

The REVOKE/IDENTIFIER command edits RIGHTSLIST.DAT, removing the 
user’s name from the list of those who hold a given identifier. The change does 
not affect the process rights list of any current processes. 

Example 

UAF> REVOKE/IDENTIFIER INVENTORY CRAMER 

%UAF-I-REVOKEMSG, identifier INVENTORY revoked from CRAMER 

The command in this example revokes the identifier INVENTORY from the user 
Cramer. Cramer loses the identifier and any resources associated with it. 

Note that because rights identifiers are stored in numeric format, it is not 
necessary to change records for users holding a renamed identifier. 


SHOW 

Displays reports for selected UAF records on the current SYS$OUTPUT device. 


Format 

SHOW user-spec 

Parameter 

user-spec 

Specifies the user name or UIC of the requested UAF record. If you omit the 
user-spec parameter, the UAF records of all users are listed. The asterisk ( ) and 
percent sign (%) wildcard characters are permitted in the user name. 


Qualifiers 


Specifies that a brief report be displayed. In the report, the Directory field 
displays one of the following items: 

• Disuser—The account has been disabled. 

• Expired—The account has expired. 

• A device and directory name—The login device and directory for the account 
(for example, DOCD$:[SMITH]). 

If you omit the /BRIEF qualifier, AUTHORIZE displays a full report. 


Specifies that a full report be displayed, including identifiers held by the user. 
Full reports include the details of the limits, privileges, login flags, and the 
command interpreter as well as the identifiers held by the user. The password is 
not listed. 

/EXACT 

Controls whether the SHOW command matches the search string exactly or 
treats uppercase and lowercase letters as equivalents. Enclose the specified 


% 
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string within quotation marks 
/SEARCH qualifiers. 


). Use /EXACT with the /PAGE=SAVE and 


/HIGHLIGHT[=keyword] 

/NOHIGHLIGHT (default) 

Identifies how to display the line that contains a string once it is found. The 
following keywords are valid: 


BLINK 

BOLD (default) 

REVERSE 

UNDERLINE 


Use the /HIGHLIGHT qualifier with the /PAGE=SAVE and /SEARCH qualifiers. 


/PAGE[=keyword] 

/NOPAGE (default) 

Controls the information display on a screen. The following keywords are valid: 


CLEAR_SCREEN 
SCROLL 
SAVE [=n] 


Clear the screen before displaying the next page 
Display a continuous stream of information 
Store information and enable the navigational keys 
listed in Table 5-3. By default, the command saves 5 
pages. The maximum page width is 255 columns. 


Table 5-3 Screen Control Keys 


Key or Key Sequence 

Action Taken When Key or Key Sequence Is Pressed 

i 

Scroll the display down one line 

< - 

Scroll the display one column to the left 


Scroll the display one column to the right 

T 

Scroll the display up one line 

Find (El) 

Search for a new string in the information being 


displayed 

Insert Here (E2) 

Move the display to the right by half a screen 

Remove (E3) 

Move the display to the left by half a screen 

Select (E4) 

Switch from 80-column displays to 132-column displays 

Prev Screen (E5) 

Return to the previous page 

Next Screen (E6) 

Display the next page 

CTRL/Z 

Return to the UAF> prompt 

Help 

Display AUTHORIZE help text 

F16 (Do) 

Switch from the oldest to the newest page 

Ctrl/W 

Refresh the display 


/SEARCH=string 

Used with the /PAGE=SAVE qualifier to specify a string to find in the information 
being displayed. You can dynamically change the search string by pressing the 
Find key (El) while the information is being displayed. 
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Description 


Examples 


/WRAP 

/NOWRAP (default) 

Used with the /PAGE=SAVE qualifier to limit the number of columns to the width 
of the screen and wrap lines that extend beyond the width of the screen to the 


next line. 

The /NOWRAP qualifier extends lines beyond the width of the screen. Use the 
/PAGE=SAVE qualifier and the screen control keys listed in Table 5-3 to view the 

entire screen. 


The SHOW command produces reports on user authorization records. You can 
select the reports to be displayed, as follows: 

• To display a single-user report, specify a user name. 

• To display reports for all users in ascending sequence by user name, specify 
an asterisk (*) wildcard character. 

• To display reports for all users with a common UIC, specify the UIC. Users 
with the same UIC are listed in the order in which they were added to the 
SYSUAF. 

You can also use the asterisk wildcard character to specify all or part of the 
UIC, as shown in the following examples: 


Command 

Description 

SHOW [14,*] /BRIEF 

Displays a brief report for all users in group 14, 

in ascending sequence by member number. 

SHOW [*,6] /BRIEF 

Displays a brief report for all users with a 
member number of 6. 

SHOW [*,*] /BRIEF 

Displays a brief report for all users, in ascending 
sequence by UIC. 


1. UAF> SHOW ROBIN 

The command in this VAX example displays a full report for the user ^BIN 
The display corresponds to the first example in the description of the ADD 
command. Most defaults are in effect. 
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ROBIN 

VMS 

DCL 

SYS$USER:[ROBIN] 


Username 
Account: 

CLI: 

Default: 

LGICMD: 

Login Flags: 

Primary days: Mon Tue Wed Thu Fri 
Secondary days: Sat Sun 

No access restrictions 


Owner: JOSEPH ROBIN 
UIC: [14,6] ([INV,ROBIN] 

Tables: DCLTABLES 


Expiration 

Pwdlifetime: 

Last Login: 

Maxjobs: 

Maxacctjobs: 

Maxdetach: 

Prclm: 

Prio: 

Queprio: 

CPU: 


0 

0 

0 

2 

4 

0 

(none) 


(none) Pwdminimum: 6 Login Fails: 0 

(none) Pwdchange: 15-JAN-1995 14:08 

(non-interactive) 


(none) 

(interactive), 

(none) 

Fillm: 

300 

Bytlm: 

32768 

Shrfillm: 

0 

Pbytlm: 

0 

BlOlm: 

40 

JTquota: 

4096 

DIOlm: 

40 

WSdef: 

256 

ASTlm: 

40 

WSquo: 

512 

TQElm: 

10 

WSextent: 

1024 

Enqlm: 

200 

Pgflquo: 

32768 


TMPMBX NETMBX 
Default Privileges: 

TMPMBX NETMBX 
Identifier 
CLASS_CA101 
CLASS_PY102 


Value 

%X80010032 

%X80010049 


Attributes 

NORESOURCE NODYNAMIC 
NORESOURCE NODYNAMIC 


Note 


The quotas Pbytlm and Queprio are placeholders only. 


2. UAF> SHOW [360,*] /BRIEF 

The command in this example displays a brief report for every user with a 
group UIC of 360. 


Owner 

JOHN JAMES 
SUSY JONES 
CLIFF BROWN 
JOY CARTER 


Username 

JAMES 

JONES 

BROWN 

CARTER 


UIC Account 
[360,201] USER 
[360,203] DOC 
[360,021] DOC 
[360,005] DOCSEC 


Privs Pri Default Directory 
Normal 4 DOCD$:[JAMES] 
Devour 4 DOCD$:[JONES] 
All 4 disuser 
Group 4 expired 


3. UAF> SHOW WELCH 


This command displays a full report for the restricted user WELCH. This 

VAX-specific display corresponds to the second example in the description of 
the ADD command. 


* 
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Owner: 
UIC: 
Tables: 


Username: WELCH 
Account: INV 
CLI: DCL 

Default: SYS$USER:[WELCH] 

LGICMD: SECUREIN _ 

Login Flags: Captive Diswelcome Disnewmail Restricted 
Primary days: Mon Tue Wed Thu Fri 

Secondary days: 

Primary 000000000011111111112222 
Day Hours 012345678901234567890123 

Network: - No access 

#########-####### 

#########-####### 

##### Full access ###### 

-####### 


ROB WELCH 
[14,51] ([14,51]) 
DCLTABLES 


#########- 


Batch: 

Local: 

Dialup: 

Remote: 

Expiration: 
Pwdlifetime: 

Last Login: 

Maxjobs: 

Maxacctjobs: 

Maxdetach: 

Prclm: 

Prio: 

Queprio: 

CPU: 

Authorized Privileges: 

TMPMBX NETMBX 
Default Privileges: 
TMPMBX NETMBX 


(none) Pwdminimum: 6 


Sat Sun 

Secondary 000000000011111111112222 
Day Hours 012345678901234567890123 
##### Full access ###### 

- ######### - 

- ######### - 

- No access - 

- ######### - 

Login Fails: 0 

(pre-expired) 

(non-interactive) 



(none) 

(interactive), 

(none) 

0 

Fillm: 

300 

Bytlm: 

32768 

0 

Shrfillm: 

0 

Pbytlm: 

0 

0 

BlOlm: 

40 

JTquota: 

4096 

2 

DIOlm: 

40 

WSdef: 

256 

4 

ASTlm: 

40 

WSquo: 

512 

4 

TQElm: 

10 

WSextent: 

1024 

(none) 

Enqlm: 

200 

Pgflquo: 

32768 


Note that WELCH is a captive user who does not receive announcements of 
new mail or the welcome message when logging in. His login command file, 
SECUREIN.COM, is presumably a captive command file that controls all of 
his operations. (Such a command file never exits, but performs operations 
for its user and logs him out when appropriate.) The CAPTIVE flag prevents 
WELCH from escaping control of the command file by using Ctrl/Y or other 
means. Furthermore, he is restricted to logging in between the hours of 
5:00 P.M. and 8:59 A.M. on weekdays and 9:00 A.M. and 5:59 P.M. on weekends. 
Although he is allowed to use dial-up lines at all times during the week, he is 
not allowed to log in over the network. On weekends, he is restncted 

so that he cannot dial in at any time or use the DCL command SE1 HOSi 
between the hours of 6:00 P.M. and 8:59 A.M. 


SHOW/IDENTIFIER 

Displays information about an identifier, such as its name, value, attributes, and 
holders, on the current SYS$OUTPUT device. 


Format 

SHOW/IDENTIFIER [id-name] 

Parameter 

id-name ., . Q1 

Specifies an identifier name. The identifier name is a string of 1 to 81 

alphanumeric characters. The name can contain underscores and dollar signs. It 
must contain at least one nonnumeric character. If you omit the identifier name, 
you must specify /USER or /VALUE. 
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Qualifiers 

/BRIEF 

Specifies a brief listing in which only the identifier name, value, and attributes 
are displayed. The default format is /BRIEF. 

/FULL 

Specifies a full listing in which the names of the identifier’s holders are displayed 
along with the identifier’s name, value, and attributes. 

/USER=user-spec 

Specifies one or more users whose identifiers are to be displayed. User-spec can 
be a user name or a UIC. You can use the asterisk wildcard to specify multiple 
UICs or all user names. UICs must be in the form [*,*], [n,*], [*,n], or [n,n], A 
wildcard user name specification (*) displays identifiers alphabetically by user 
name, a wildcard UIC specification ([*,*]) displays them numerically by UIC. 

/VALUE=value-specifier 

Specifies the value of the identifier to be listed. The following are valid formats 
for the value-specifier: 

IDENTIFIERm An integer value in the range of 65,536 to 

268,435,455. You can also specify the value in 
hexadecimal (precede the value with %X) or octal 
(precede the value with %0). 

To differentiate general identifiers from UIC 
identifiers, %X80000000 is added to the value 
you specify. 

UIC:uic A UIC value in the standard UIC format. 


See also the screen control qualifiers listed under the SHOW command: 

/EXACT 

/HIGHLIGHT[=keyword] 

/NOHIGHLIGHT (default) 

/PAGE[=keyword] 

/NOPAGE (default) 

/SEARCH=string 

/WRAP 

/NOWRAP (default) 

Description 

The SHOW/IDENTIFIER command displays identifier names, values, attributes, 
and holders in various formats depending on the qualifiers specified. Two of these 
formats are illustrated in the following examples. 
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Examples 


1. UAF> SHOW/IDENTIFIER/FULL INVENTORY 

The command in this example would produce output similar to the following: 


Name 

INVENTORY 

Holder 

ANDERSON 

BROWN 

CRAMER 


Value Attributes 

%X80010006 NORESOURCE NODYNAMIC 

Attributes 

NORESOURCE NODYNAMIC 
NORESOURCE NODYNAMIC 
NORESOURCE NODYNAMIC 


2 . 


UAF> SHOW/IDENTIFIER/USER=ANDERSON 

This command displays the identifier associated with the user ANDERSON, 
as follows: 


Name 

ANDERSON 


Value Attributes 

[000300,000015] NORESOURCE NODYNAMIC 


The identifier is shown, along with its value and attributes. Note, 
however, that this is the same result you would produce had you specified 
ANDERSON’s UIC with the following forms of the command: 


UAF> SHOW/IDENTIFIER/USER=[300,015] 

UAF> SHOW/ IDENTIFIER/VALUE=UIC:[300,015] 


SHOW/PROXY 

Displays all authorized proxy access for the specified remote user. 

Format 

SHOW/PROXY node::remote-user 

Parameters 

node 

Specifies the name of a network node in the network proxy authorization file. The 
asterisk wildcard is permitted in the node specification. 

remote-user 

Specifies the user name or UIC of a user on a remote node. The asterisk wildcard 
is permitted in the remote-user specification. 
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Description 

Examples 


AUTHORIZE 

SHOW/PROXY 


/OLD 

2“^ S Z StemS > directs AUTHORIZE to display information from 
NETPROXY.DAT rather than the default file NET$PROXY.DAT. ♦ 

If someone modifies the proxy database on a cluster node that is not running the 
current OpenVMS VAX system, then you can use the /OLD qualifier to display 
the contents of the old database: NETPROXY.DAT. 


See also the screen control qualifiers listed under the SHOW command: 

/EXACT 

/HIGH LIGHT[=key word] 

/NOHIGHLIGHT (default) 

/PAGE[=keyword] 

/NOPAGE (default) 

/SEARCH=string 

/WRAP 

/NOWRAP (default) 


The SHOW/PROXY command displays the first 255 characters of a node name 
although the command can handle a maximum of 1024 characters. 


1. UAF> SHOW/PROXY SAMPLE: : [200,100] 

Default proxies are flagged with an 

SAMPLE::[200,100] 

MARCO * 

PROXY3 


PROXY2 


The command in this example displays all authorized proxy access for the 
user on node SAMPLE with a UIC of [200,100], The default proxy account 
can be changed from MARCO to PROXY2 or PROXY3 with the MODIFY 
/PROXY command. 


UAF> SHOW/PROXY *::* 

Default proxies are flagged with (D) 

TAO: . TWA. RANCH: : MARTINEZ 

MARTINEZ (D) SALES_READER 

UAF> show/proxy/old *::* 

Default proxies are flagged with (D) 

RANCH::MARTINEZ 

MARTINEZ (D) SALES_READER 

The command in this VAX example displays information about local 
authorized proxy access on a system running DECnet/OSI. The first command 
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draws information from the file NET$PROXY.DAT. By including the /OLD 
qualifier on the SHOW/PROXY command, AUTHORIZE displays information 
from the file NETPROXY.DAT, which was used in earlier versions of the 


operating system. 


SHOW/RIGHTS 

Displays the identifiers held by the specified identifiers or, if /USER is specified, 
all identifiers held by the specified users. 


Format 

SHOW/RIGHTS [id-name] 


Parameter 

Specifies the name of the identifier associated with the user. If you omit t 
identifier name, you must specify the /USER qualifier. 


Qualifier 


/USER=user-spec , 

Specifies one or more users whose identifiers are to be listed. User-spec can be a 
user name or a UIC. You can use the asterisk wildcard to specify multiple UICs 
or all user names. UICs must be in the form [*,*], [n,*], [*,n], or [n,n . A wildcard 
user name specification (*) or wildcard UIC specification ([*,*]) displays all , 
identifiers held by users. The wildcard user name specification displays holders 
user names alphabetically; the wildcard UIC specification displays them in the 
numerical order of their UICs. 

See also the screen control qualifiers listed under the SHOW command. 


/EXACT 

/HIGHLIGHT[=keyword] 
/NOHIGHLIGHT (default) 

/PAGE[=keyword] 
/NOPAGE (default) 

/SEARCH=string 

/WRAP 

/NOWRAP (default) 


Description 

Output displayed from the SHOW/RIGHTS command is identical to that written 
to RIGHTSLIST.LIS when you use the LIST/RIGHTS command. 
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Example 

UAF> SHOW/RIGHTS ANDERSON 

This command displays all identifiers held by the user ANDERSON. For example: 

Name Value Attributes 

INVENTORY %X80010006 NORESOURCE NODYNAMIC 

PAYROLL %X80010022 NORESOURCE NODYNAMIC 

Note that the following formats of the command produce the same result: 

SHOW/RIGHTS/USER=ANDERSON 

S HO W/RIG HT S/U S E R=[300,015] 
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AUTOGEN Description 

The AUTOGEN command procedure (SYS$UPDATE:AUTOGEN.COM) sets 
appropriate values for system parameters and sizes for system page, swap, and 
ump files. AUTOGEN runs automatically when you install or upgrade the 
operating system. In addition, you can use AUTOGEN whenever you want to 
reset system parameter values, system file sizes, or both. The new values and file 
sizes take effect the next time the system is booted. Digital recommends that you 
run AUTOGEN on a weekly basis to adjust system parameters according to your 
system's work load. For a list and description of all system parameters, see the 
UpenVMS System Management Utilities Reference Manual: M-Z. 

AUTOGEN executes in phases with each phase performing a separate task. You 
control which tasks AUTOGEN performs by specifying a start phase and an end 
phase when you invoke AUTOGEN. For more information on the AUTOGEN 
phases, see Section 6.3. 

You can add commands to the file SYS$SYSTEM:MODPARAMS.DAT to control 
the system parameter values and file sizes that AUTOGEN sets. AUTOGEN 
uses the information in this file to determine final values for system parameters 
or page, swap or dump file sizes. For more information, see the chapter about 
managing system parameters in the OpenVMS System Manager’s Manual. 

AUTOGEN can improve system performance by using dynamic information, 
called feedback, gathered from the running system. 

---Note_ 

When making major configuration changes, do not use feedback. Specify 
nofeedback to assure the use of the initial AUTOGEN settings. See 
Table 6-4 for more information about nofeedback. 


You control how AUTOGEN uses feedback by specifying an execution mode 
when you invoke AUTOGEN. To direct AUTOGEN to use feedback to make its 
calculations, you run AUTOGEN in feedback mode. After a period of time, you 
might want to execute AUTOGEN in feedback mode to further refine system 
parameter settings. For more information about AUTOGEN feedback see 
Section 6.2. 

6.1 When to Run AUTOGEN 

Digital recommends that you run AUTOGEN in the following circumstances: 

• During a new installation or upgrade. 

• Whenever your work load changes significantly. 

• When you add an optional (layered) software product. Certain layered 
products might require you to execute AUTOGEN to adjust parameter values 
and page and swap file sizes. (For information on using AUTOGEN to modify 
page and swap files, see the chapter on managing page, swap, and dump 
files in the OpenVMS System Manager’s Manual.) See the specific product 
documentation for installation requirements. 

• When you install images with the /SHARED attribute. The GBLSECTIONS 
and GBLPAGES parameters might need to be increased to accommodate 
additional use of global pages and global sections. 
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• During normal operation, as part of a batch-oriented command procedure that 
runs AUTOGEN on a regular basis and automatically sends a report to an 
appropriate MAIL account. The recommended procedure is described in the 
chapter on managing system parameters in the OpenVMS System Manager s 
Manual . 

After a new operating system installation or upgrade, examine the results of 
calculations that AUTOGEN made to determine whether AUTOGEN has set 
system parameter values that are appropriate for your workload requirements. 

Table 6-1 lists the system parameters affected by AUTOGEN calculations. In 
addition to these system parameters, AUTOGEN calculations also affect the size 
of page, swap and dump files. Table 6-2 lists the system parameters affected by 
AUTOGEN feedback. 


Table 6-1 System Parameters Affected by AUTOGEN Calculations 


ACP_DINDXCACHE 

ACP_DIRCACHE 

ACP HDRCACHE 

ACP MAPCACHE 

ACP_QUOCACHE 

ACP_SWAPFLGS 

acp_sysacc 

BALSETCNT 

BORROWLIM 

DUMPSTYLE 

EXPECTED_VOTES 

FREEGOAL 

FREELIM 

GBLPAGES 

GBLSECTIONS 

$GH_RSRVPGCNT 

GROWLIM 

$ITB_ENTRIES 

LNMSHASHTBL 

LOCKDIRWT 

LOCKIDTBL 

tLOCKIDTBL_MAX 

MAXPROCESSCNT 

MPW_HILIMIT 

$MPW_THRESH 

MPW_LOLIMIT 

MPW_LOWAITLIMIT 

MPW_WAITLIMIT 

MSCPJBUFFER 

MSCP_LOAD 

NISCS_PORT_SERV 

NPAGEDYN 

NPAGEVIR 

PAGEDYN 

PASTDGBUF 

PFCDEFAULT 

tPHYSICALPAGES 

PIXSCAN 

PQL_DWSDEFAULT 

PQL_DWSEXTENT 

PQL_DWSQUOTA 

PQL.MWSDEFAULT 

PQL_MWSEXTENT 

PQL_M W SQU OTA 

RESHASHTBL 

SCSCONNCNT 

SCSBUFFCNT 

tSCSRESPCNT 

tSHADOW_MAX_COPY 

tSPTREQ 

tSWPOUTPGCNT 

SYSMWCNT 

tVAXCLUSTER 

VIRTUALPAGECNT 

VOTES 

WSDEC 

tWSINC 

WSMAX 

ZERO_LIST_HI 


fVAX specific 



iAlpha specific 




6.2 Feedback 

AUTOGEN feedback minimizes the necessity to modify parameter values or 
system file sizes. Feedback allows AUTOGEN to automatically size the operating 
system based on your actual work load. Sizing is the process of matching 
the allocation of system resources (memory and disk space) with the workload 
requirements of your site. 
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Feedback is information about how various resources are used by the system’s 
work load. This information is continuously collected by the operating system 
executive. Because the system collects feedback when exception events occur 
feedback collection does not affect system performance. 

You control how AUTOGEN uses feedback by specifying an execution mode 
when you invoke AUTOGEN. When run in feedback mode, AUTOGEN analyzes 
this information and adjusts any related parameter values. For information on 
controlling AUTOGEN’s use of feedback, see Section 6 4 


AUTOGEN collects feedback during the SAVPARAMS phase by executing the 
image SYS$SYSTEM:AGEN$FEEDBACK.EXE. AUTOGEN writes feedback 
information to the file SYS$SYSTEM:AGEN$FEEDBACK.DAT. This file is then 
read during the GETDATA phase. For more information on AUTOGEN phases 
see Section 6.3. ’ 


Table 6-2 lists the system parameters affected by AUTOGEN feedback. In 
addition to these system parameters, feedback also affects the size of page and 
swap files. 


Table 6-2 System Parameters Affected by AUTOGEN Feedback 


ACP DINDXCACHE 

ACP_DIRCACHE 

ACP_HDRCACHE 

ACPJMAPCACHE 

GBLPAGES 

GBLSECTIONS 

LOCKIDTBL 

tLOCKIDTBL_MAX 

LNMSHASHTBL 

tGH_RSRVPGCNT 

tITB_ENTRIES 

MAXPROCESSCNT 

MSCP_BUFFER 

NPAGEDYN 

PAGEDYN 

RESHASHTBL 

SCSBUFFCNT 

SCSCONNCNT 

tSCSRESPCNT 

+VAV- 




tVAX specific 

tAlpha specific 


6.3 Phases 

AUTOGEN executes in phases. You control which tasks AUTOGEN performs 
by specifying a start phase and an end phase when you invoke AUTOGEN. 
Table 6—3 lists the phases AUTOGEN can execute in order. 


Table 6-3 AUTOGEN Phases 

Phase Description 


SAVPARAMS 

GETDATA 

GENPARAMS 

TESTFILES 

GENFILES 


Saves dynamic feedback from the running system. 

Collects all data to be used in AUTOGEN calculations. 

Generates new system parameters; creates the installed image 
list. 

Displays the system page, swap, and dump file sizes calculated 
by AUTOGEN (cannot be used as a start phase). 

Generates new system page, swap, and dump files if 
appropriate (cannot be used as a start phase). 


(continued on next page) 
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Table 6-3 (Cont.) 

AUTOGEN Phases 

Phase 

Description 

SETPARAMS 

Runs SYSMAN to set the new system parameters in the 
default parameter file, saves the original parameters, and 
generates a new parameter file, AUTOGEN.PAR. 

SHUTDOWN 

Prepares the system to await a manual reboot. 

REBOOT 

Automatically shuts down and reboots the system. 

HELP 

Displays help information to the screen. 


The following sections describe each phase in detail. 


6.3.1 SAVPARAMS 

The SAVPARAMS phase records feedback in the file AGEN$FEEDBACK.DAT, 
which can be used in subsequent AUTOGEN phases. If you specify 
NOFEEDBACK as the execution-mode parameter, the information collected 

is not used. 

The SAVPARAMS phase is valid as a start phase and end-phase. SAVPARAMS 
requires the SYSPRV and CMKRNL privileges. 

____ Note--- 

You can specify the SAVE.FEEDBACK option during an interactive 
orderly shutdown with SYS$SYSTEM:SHUTDOWN.COM. Entering this 
option in response to the prompt “Shutdown options: records feedback 
collected since the system was last booted. Using the SAVE_FEEDBACK 
option creates a new version of SYS$SYSTEM:AGEN$FEEDBACK.DAT. 
Run AUTOGEN from the GETDATA phase after the system reboots to 
use this new version of the feedback. 


6.3.2 GETDATA 

The GETDATA phase collects the following information required for AUTOGEN 
calculations and places it in the file PARAMS.DAT: 

• Hardware configuration data 

• Digital-supplied data from VMSPARAMS.DAT 

• Feedback from AGEN$FEEDBACK.DAT (if run in feedback mode) 

• User-supplied data from MODPARAMS.DAT 

The GETDATA phase also attempts to configure devices on the system, by 
executing the following: 

• The command procedure SYS$MANAGER:SYCONFIG.COM. (For more 
information on this procedure, see the chapter on managing devices in the 
OpenVMS System Manager’s Manual.) 

• The SYSGEN command AUTOCONFIGURE ALL (unless the symbol 
STARTUP$AUTOCONFIGURE_ALL is set to 0 in SYCONFIG.COM). 

The GETDATA phase is valid as a start phase and an end phase. GETDATA 
requires the SYSPRV and CMKRNL privileges. 
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6.3.3 GENPARAMS 


the GENPARAMS phase, AUTOGEN calculates the parameter values based 

ATTTnn^S re u 1T l PARAMS DAT and produces SETPARAMS.DAT as output 
AUTOGEN checks to see if feedback is included, and if so, uses it in the 

JjfmrTO unless the NOFEEDBACK execution mode was specified when 
AUTOGEN was invoked. Also during this phase, AUTOGEN generates the 
known image file list (VMSIMAGES.DAT). 

PhaSe iS Vahd aS a Start phase and an end P ha se. 
GENPARAMS requires the SYSPRV and OPER privileges. 

6.3.4 TESTFILES 

The TESTFILES phase displays system page, swap, and dump file sizes 
calculated by AUTOGEN. (This phase does not change the file sizes.) 

File sizes for all currently installed primary and secondaiy page and swap 
hies are displayed. The information is directed to SYS$OUTPUT and the 
AGEN$PARAMS.REPORT file by default. 

Specify the TESTFILES phase to display AUTOGEN’s file size calculations- 
to generate new sized files, specify the GENFILES phase. You cannot specify 
“ ( ^ haae P hase « wh “ invoking AUTOGEN. Digital recommends you use 
1 ESI FILES to display the file size changes before actually generating new sized 
tiles on your system. 

c5o^? TFIL ? S phaSe is Valid only as an end P hase - TESTFILES requires the 
SYSPRV privilege. 

6.3.5 GENFILES 

The GENFILES phase generates the new page, swap, and dump files on the 
system. This phase changes the file sizes based on AUTOGEN’s calculations. 

The GENFILES phase does not modify a file if the calculated size change is 
within ten percent of the existing file size. The following files are affected: 
AGEFILE.SYS, SWAPFILE.SYS, SYSDUMP.DMP, and all other currently 
installed page and swap files. For more information, see the chapter on managing 
page, swap and dump files in the OpenVMS System Manager’s Manual. 

GENFILES is valid only as an end phase. GENFILES requires the SYSPRV 
privilege. 

6.3.6 SETPARAMS 

The SETPARAMS phase uses as its input the SETPARAMS.DAT file created 
during the GENPARAMS phase. In this phase, AUTOGEN runs SYSMAN to 
update the system parameter values in the default parameter file. 

On VAX systems, the default parameter file is SYS$SYSTEM:VAXVMSSYS.PAR 
AUTOGEN saves the current system parameters in the file 
SYS$SYSTEM:VAXVMSSYS.OLD before updating these parameters in 
SYS$SYSTEM:VAXVMSSYS.PAR. The new values are also sa“ed in 
SYS$SYSTEM:AUTOGEN.PAR. ♦ 
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Alpha 


On Alpha systems, SYS$SYSTEM:ALPHAVMSSYS.PAR is the default 
parameter file AUTOGEN saves the current system parameters in the 
file SYS$SYSTEM:ALPHAVMSSYS.OLD before updating these parameters 
in SYS$SYSTEM:ALPHAVMSSYS.PAR. The new values are also saved in 
SYS$SYSTEM:AUTOGEN.PAR. ♦ 

The SETPARAMS phase is valid as a start phase and an end phase. 
SETPARAMS requires the SYSPRV and OPER privileges. 


6.3.7 SHUTDOWN 

SHUTDOWN shuts down the system and awaits a manual reboot. To use the new 
system parameter values generated in the SETPARAMS phase, specify eit er 
SHUTDOWN or REBOOT as the end phase. You can define the logical name 
AGEN$SHUTDOWN_TIME (using the DCL command DEFINE) to specify the 
number of minutes before shutdown occurs. 

SHUTDOWN requires the SETPRV privilege. 


6.3.8 REBOOT 

REBOOT automatically shuts down and reboots the system thus installing the 
new parameter values. To install the new system parameter values generated 
in the SETPARAMS phase, specify either SHUTDOWN or REBOOT as the end 
phase. You can define the logical name AGEN$SHUTDOWN_TIME (using the 
DCL command DEFINE) to specify the number of minutes before shutdown 
occurs. 


REBOOT requires the SETPRV privilege. 

6.3.9 HELP 

HELP displays help information about AUTOGEN to the screen. The HELP 
phase is only valid as the start phase command line parameter. When you specify 
HELP for the start phase, the end phase and execution mode parameters are 

ignored. 


6.4 Execution Modes 

You specify an execution mode when you invoke AUTOGEN to control how 
AUTOGEN uses feedback. Table 6-4 lists the execution-mode options. 


Table 6-4 AUTOGEN Execution Modes 


Option 

FEEDBACK 

NOFEEDBACK 


Description_ 

Specifies that AUTOGEN run in feedback mode, using dynamic 

feedback collected during the SAVPARAMS phase to make its 
calculations. 

Specifies that AUTOGEN not use feedback in the calculations. 
The feedback from the SAVPARAMS phase is ignored. Use 
NOFEEDBACK mode for the initial system installation or 
upgrade. NOFEEDBACK supersedes the execution-mode option 
INITIAL, which was used in a previous version of the operating 


system. 


(continued on next page) 
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Table 6-4 (Cont.) AUTOGEN Execution Modes 


Option 


Description 


CHECK_FEEDBACK 


Blank 


Specifies that AUTOGEN use feedback in its calculations as long 
as the feedback is valid. If feedback is suspect, AUTOGEN does 
not use feedback in the calculations, but continues through the 
specified end phase. 

If you do not specify an execution mode, AUTOGEN uses 
feedback in the calculations by default. However, if AUTOGEN 
determines that the feedback might be suspect, it performs 
the calculations, issues the feedback report, and stops before 
modifying any parameters or system files, even if you specified 
an end phase of GENFILES, SETPARAMS, SHUTDOWN or 
REBOOT. 


6.5 Files Used by AUTOGEN 

Table 6—5 lists the files AUTOGEN uses during each phase. 


Table 6-5 Files Used by AUTOGEN 


AUTOGEN Phase 

Input Files 1 

Output Files 1 

SAVPARAMS 

None 

AGEN$FEEDBACK.DAT 

GETDATA 

MODPARAMS.DAT 

VMSPARAMS.DAT 

AGEN$FEEDBACK.DAT 

PARAMS.DAT 

GENPARAMS 

PARAMS.DAT 

SETPARAMS.DAT 

VMSIMAGES.DAT 

AGEN$PARAMS.REPORT 

TESTFILES 

PARAMS.DAT 

SYS$OUTPUT 

GENFILES 

PARAMS.DAT 

PAGEFILE.SYS 

SWAPFILE.SYS 
(and secondary page 
and swap files) 

SYSDUMP.DMP 

AGEN$PARAMS.REPORT 

SETPARAMS 

SETPARAMS.DAT 

fVAXVMSSYS.PAR 

tALPHAVMSSYS.PAR 

AUTOGEN.PAR 

tVAXVMSSYS.OLD 

JALPHAVMSSYS.OLD 

SHUTDOWN 

None 

None 

REBOOT 

None 

None 


. * wmcn contains tne installed image list, reside in 

SYS$SYSTEM directory. VMSIMAGES.DAT resides in the SYS$MANAGER directory 
fVAX specific 
$Alpha specific 


‘j? aoVQGt 




tyeXox ifo. u_xS> 
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The AUTOGEN command procedure runs automatically when your system is 
installed or upgraded to set appropriate values for system parameters and sizes 
for system page, swap, and dump files. 

Execute AUTOGEN to reset system parameter values and system file sizes. The 
new values and file sizes take effect the next time the system is booted. 

To invoke AUTOGEN enter a command in the following format at the DCL 
command prompt: 

Format 

@SYS$UPDATE:AUTOGEN [start-phase] [end-phase] [execution-mode] 

Parameters 

start-phase 

Specify the phase where AUTOGEN is to begin executing. Table 6-3 lists the 
options for the end-phase parameter. 

The phase specified for start-phase must either precede or be identical to the 
phase specified for end-phase, according to the sequence shown in Table 6-3. If 
you do not supply an option for the start-phase parameter, enter a null argument 
(that is, " “ ). If you do not specify a start phase, GENPARAMS is the default. 

end-phase 

Specify the phase where AUTOGEN is to complete executing. Table 6-3 lists the 
options for the end-phase parameter. If you do not specify an end phase, the end 
phase has the same value as the start phase by default. 

execution-mode 

Specify one of the following execution-mode options to control how AUTOGEN 
uses feedback: 

• FEEDBACK 

• NOFEEDBACK 

• CHECK-FEEDBACK 

• Blank 

Table 6-4 describes each execution-mode option. 
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BACKUP Description 

The Backup utility (BACKUP) helps you prevent data loss or corruption by 
creating copies of your files, directories, and disks. In case of a problem, for 
example, a disk drive failure, you can restore the backup copy and continue your 
work with minimal disruption. 

When you save files with BACKUP, it writes the files to a special file called a 
save set. Save sets are written in a format that only BACKUP can interpret. 

(A save set stored on a Files-11 disk is a standard OpenVMS file, however, and 
can be copied, renamed, deleted, or backed up. A save set stored on magnetic 
tape should only be processed with the BACKUP command; do not use the DCL 
command COPY to copy a magnetic tape save set to disk.) 

Use BACKUP to perform the following tasks: 

• Save disk files to a BACKUP save set. 

• Restore files to disk from a BACKUP save set. 

• Copy disk files to disk files. 

« 

• Compare disk files created by BACKUP or files in a BACKUP save set with 
disk files . 

• List information about the files in a BACKUP save set. 

• Create and list journal files that record the results of BACKUP save 
operations. 

For specific information about performing these tasks, see the OpenVMS System 
Manager’s Manual. 


-- Note __ 

Some layered products have their own special backup procedures. For 
more information, see the layered product documentation. 


Using BACKUP also eliminates disk fragmentation. Fragmentation can occur 
as you create and extend files on a disk. If the file system cannot store files in 
contiguous blocks, it stores them in noncontiguous pieces. Eventually, the disk 
can become severely fragmented and system performance suffers. To eliminate 
fragmentation, perform an image backup of the disk and restore the backup 
copy. When you restore the image backup, BACKUP places the files on the disk 
contiguously. 

Besides backing up your own files, directories, and disks, remember to back up 
your OpenVMS system disk. Depending on the policy at your site, individuals 
may be responsible for backing up their system disks, or an operator or system 
manager may perform the backup (as would likely be the case in a large, 
clustered computer system). 

The two ways to back up your system disk are: 

• If you have access to the OpenVMS Alpha or VAX system CD-ROM, you can 
use a menu-driven procedure to back up your system disk. 
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• If you do not have access to the OpenVMS Alpha or VAX system CD ROM, 
you must use standalone BACKUP to back up your system disk. 

See the OpenVMS System Manager’s Manual for more information about 
standalone BACKUP and the menu-driven procedure. 

Types of backup operations are: 

• An image backup (also called a full backup) saves a copy of all the files on a 
disk (or volume) to a save set. The first backup that you do on a disk must be 
an image backup; you cannot perform an incremental backup first. 

• An image restore initializes the output disk and restores an entire volume. 

• An image copy operation initializes the output disk and copies an entire 
volume; the image backup is a logical duplicate of the contents of the disk. 

• An image compare operation compares the contents of entire volumes. 

_Note- 

Because an image copy or backup operation processes all files on the input 
volume, you cannot specify file-selection qualifiers for these operations. 

You can, however, restore files and directories selectively from an image 
save set. 


If the output volume of an image operation is a disk, BACKUP stores all 
files on the output volume contiguously, eliminating disk fragmentation and 
creating contiguous free blocks of disk space. 

• An incremental backup saves only those files that have been created 
or modified since the most recent backup that was performed using the 
/RECORD qualifier. (The /RECORD qualifier records the date and time that 
the files are backed up.) 

• An incremental restore operation restores an incremental save set. Specify 
the command qualifier /INCREMENTAL in an incremental restore operation. 

• A file operation processes individual files or directories. 

• A selective operation process files or volumes selectively, according to criteria 
such as version number, file type, UIC, date and time of creation, expiration 
date, or modification date. 

Perform selective save operations by using wildcard characters and input 
file-selection qualifiers (for example, /BACKUP, /BEFORE, /BY_OWNER 
(/OWNERJJIC), /CREATED, /EXCLUDE, /EXPIRED, /MODIFIED, and 
/SINCE). 

• A physical operation copies, saves, restores, or compares an entire volume in 
terms of logical blocks, ignoring any file structure. 

The following sections describe the BACKUP command line format. 
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7.1 BACKUP Command Line Format 

To perform BACKUP operations, enter the DCL command BACKUP in the 
following format: 

BACKUP input-specifier output-specifier 

BACKUP evaluates the input and output specifiers to determine which type of 
operation to perform. BACKUP also uses the input specifier to locate the input 
and directs output to the output specifier. 

7.2 BACKUP Input and Output Specifiers 

BACKUP can process several different types of input and output. Depending 
on the type of operation being executed, input and output specifiers can be 
standard Open VMS file specifications, BACKUP save-set specifications, or device 
specifications. Device specifications can refer to disk or magnetic tape volumes. 

You can specify any valid OpenVMS file specification as BACKUP input or 
output specifiers; however, BACKUP does not allow node names in BACKUP file 
specifications. You can use wildcard characters, and you can list multiple file 
specifications as input to a single BACKUP operation. 

A BACKUP save-set specification is the file specification of a BACKUP save 
set. When you use BACKUP to save files or volumes, it writes your files to a 
save set. You can specify the save set as input to other BACKUP operations. 
When specifying a save set, follow the rules for specifying a OpenVMS file. 

The OpenVMS User’s Manual describes valid specifications for disk files; the 
OpenVMS System Manager s Manual explains the rules for specifying magnetic 
tape files. A save-set specification has no default file type, although you can use 
BCK or SAV. 

The save-set name can be any valid OpenVMS file name and type. However, 
when you create a save set on magnetic tape, the save-set name has the following 
restrictions: 

• The entire save-set name cannot exceed 17 characters, including the period 
delimiter. 

• You cannot specify a version number. 

• You cannot specify a directory name. 

Device specifications used as BACKUP input or output specifiers follow the 
conventions for specifying devices outlined in the OpenVMS User’s Manual. 

By default, BACKUP treats an input or output specifier referring to a Files—11 
disk as a file specification. Therefore, to identify a save set on a Files-11 volume, 
you must include the /SAVE_SET qualifier with the specifier (see /SAVE_SET). 
BACKUP treats input and output specifiers referring to magnetic tape as save 
sets. 

----- Note_ 

You cannot specify a save set for both the input and output specifier of 
a BACKUP command. For this reason, you cannot perform a BACKUP 
operation from one magnetic tape to another. 

--- 
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Table 7-1 shows input and output specifiers for each type of BACKUP operation. 


Table 7-1 BACKUP Input and Output by Operation Type 


Operation 

Format 

Save 

BACKUP file-spec save-set-spec 

Save (image) 

BACKUP/IMAGE device-spec save-set-spec 

Save (physical to disk) 

BACKUP/PHYSICAL device-spec device-spec 

Restore 

BACKUP save-set-spec file-spec 

Restore (image) 

BACKUP/IMAGE save-set-spec device-spec 

Restore (physical from 
disk) 

BACKUP/PHYSICAL save-set-spec device-spec 

Restore (physical from 
tape) 

BACKUP/PHYSICAL save-set-spec device-spec 

Copy 

BACKUP file-spec file-spec 

Copy (image) 

BACKUP/IMAGE device-spec device-spec 

Copy (physical to tape) 

BACKUP/PHYSICAL device-spec save-set-spec 

Compare 

BACKUP/COMPARE file-spec file-spec 

BACKUP/COMPARE save-set-spec file-spec 

Compare (image) 

BACKUP/COMPARE/IMAGE save-set-spec device-spec 
BACKUP/COMPARE/IMAGE device-spec device-spec 

Compare (physical) 

BACKUP/COMPARE/PHYSICAL device-spec device-spec 
BACKUP/COMPARE/PHYSICAL save-set-spec device-spec 

List 1 

BACKUP/LIST[=file-spec] save-set-spec 
BACKUP/LIST[=file-spec] device-spec 

Create Journal 

BACKUP/JOURNAL[=file-spec] file-spec save-set-spec 

List Journal 

BACKUP/JOURNAL[=file-spec]/LIST[=file-spec] 

1 Can also be used in conjunction with any other operation listed here. 


7.2.1 Input and Output Specifier Element Lists 

An element list is a list of arguments specified with a command or qualifier. 

The arguments, or elements, in the list are separated by commas. Element 
lists relating to input or output specifiers are allowed only in the following 
circumstances: 

• If an input specifier refers to a Files—11 disk, you can construct lists from 
standard OpenVMS file specifications, as follows: 

$ BACKUP 

_From: DUAO:[DATA]A.DAT,B.DAT,[PROGRAMS]TEST.EXE 
_To: MSAO: TEST. SAV/ LABEL=DLY101 

• If an input specifier or an output specifier refers to a BACKUP save set on 
magnetic tape or sequential disk, you can specify more than one device name 
to be used in the operation. This allows you to process multivolume save sets 
efficiently by specifying the order in which devices will be used. The first 
volume is processed until it is full. The second (or subsequent) volume is 
processed while the media in the first (or previous) volume is being changed. 
However, the save-set name must appear with the first element in the list 
and must not appear in subsequent elements in the list. 


7-6 











BACKUP Description 


In the following example, BACKUP first saves data to a tape in drive MSAO, 
then to a tape in drive MSA1. When the tape in drive MSA1 is full, BACKUP 
saves data to a fresh tape in MSAO. 

$ BACKUP 

_From: DUAO:[DATA] *.*, DUAO:[PROGRAMS]*.* 

—To: MSAO:TEST.SAV,MSA1:/LABEL=WKLY01 

• If you are performing an image operation on a volume set, you can specify 
element lists in the input and output specifiers. In the following example, 
BACKUP first restores the save set TEST.SAV from the tape in drive MSAO, 
and then continues to restore the save set from the tape in drive MSA1. 
BACKUP first restores this save set to DUAO. When DUAO is full, BACKUP 
continues the restore operation to DUA1. 

$ BACKUP/IMAGE 

_From: MSA0:TEST.SAV,MSA1: 

_To: DUAO:[DATA...],DUA1: 

7.2.2 BACKUP Qualifiers 

You can also affect BACKUP operations by specifiying qualifiers. BACKUP has 
five types of qualifiers: 

• Command qualifiers allow you to modify the default action of a BACKUP 
command. You can place command qualifiers anywhere in the command line. 
Command qualifiers act upon every file in the input or output specifier. 

• Input file-selection qualifiers select files from the input specifier. Place 
them immediately after the input specifier. 

• Input save-set qualifiers affect the way BACKUP handles an input save 
set during a restore or compare operation. Place them immediately after the 
input specifier. 

• Output file qualifiers change the way output files are restored. Place them 
immediately after the output specifier. 

• Output save-set qualifiers affect the way BACKUP processes an output 
save set during a save operation. Place them immediately after the output 
specifier. 

-Note __ 

You cannot use input and output qualifiers in image operations. 


It is important to understand the differences between the types of qualifiers. The 
position of qualifiers in the BACKUP command line affects the results of the 
command. Although command qualifiers can be placed anywhere in the command 
line, input- and output-specifier qualifiers are position-dependent. That is, input- 
specifier qualifiers must be placed immediately after the input specifier, and 
output-specifier qualifiers must be placed immediately after the output specifier. 

Additionally, several BACKUP qualifiers are both input-specifier qualifers and 
output-specifier qualfiers. To achieve the results you want from a BACKUP 
command, ensure that you place position-dependent qualifiers correctly. For 
example, use the /SAVE_SET qualifier as an output save-set qualifier in a 
BACKUP save operation and as an input save-set qualifier in a BACKUP restore 
operation. 
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Appendix G contains more information about valid combinations of BACKUP 
qualifiers. 

7.2.3 Using Wildcard Characters with BACKUP 

BACKUP allows you to use wildcard characters in file specifications to represent 
directories, file names, file types, and version numbers. Omitted file names, file 
types, or version numbers are assumed to be the asterisk wildcard character. For 
instance, if you omit the version number, BACKUP processes all versions. (For 
introductory information on wildcard characters, refer to the OpenVMS User’s 
Manual.) 

You can use any valid DCL wildcard character with input specifiers that are 
Files-11 media or with the /SELECT and /EXCLUDE qualifiers. Note, however, 
that the symbols denoting the latest versions of files (;) and relative versions of 
files (;-n) are processed as the asterisk wildcard character (;*) when they are used 
with the /EXCLUDE and /SELECT qualifiers. 

You cannot use wildcard characters in BACKUP save-set specifications unless the 
save sets are input specifiers on tape. 

Using Wildcard Characters to Represent Directories 

Table 7-2 lists the types of directory wildcards allowed for output specifiers that 
are Files-11 media. 


Table 7-2 Wildcards for Files-11 Output Specifiers 


Directory Wildcard 

Result 

omitted 

If a directory name is omitted, BACKUP restores file to the 
current default directory []. 

[*...] 

BACKUP restores files to the directory from which they 
were saved. 

[directory] 

BACKUP restores files to the named directory. 

[directory . . . ] 

The wildcard characters used in the specification of the 
input files determine the directory to which BACKUP 


restores the files. 


__ Note_ 

If you specify directory wildcard characters incorrectly and your 
directories contain many levels of subdirectories, you risk losing the 
lower level subdirectories in BACKUP operations because OpenVMS 
directory trees can have only eight levels. 


The following example uses the directory wildcard format [directory . . . ] for both 
the input and the output specifiers: 

$ BACKUP [OSCAR...] [JOE.RECEIVED...] 

In this example, BACKUP creates a directory named [JOE.RECEIVED] (if it does 
not already exist) as well as subdirectories that correspond to the subdirectories 
of [OSCAR], BACKUP copies all files from the directory [OSCAR] and its 
subdirectories to [JOE.RECEIVED] and its subdirectories. If [OSCAR] has 
eight levels of directories, however, BACKUP is unable to create a corresponding 
ninth-level subdirectory to [JOE.RECEIVED]; the eighth-level subdirectory to 
[OSCAR] is not copied. 


7-8 

















BACKUP Description 


If you use the asterisk wildcard character (*) to represent subdirectories in 
t e input specifier of a copy operation, BACKUP creates subdirectories to the 
directory specified in the output specifier that correspond to the subdirectories 
in the input specifier. BACKUP then copies all files from the lowest level 
subdirectory in the input specifier to the lowest level subdirectory in the output 

*P*™' r In the Allowing example, the asterisk represents subdirectories named 
MONDAY and TUESDAY: 

$ BACKUP [SAM.WORK.*.WEDNESDAY] [JAMES...] 

In this example, BACKUP creates a subdirectory named 
[JAMES.MONDAY.TUESDAY.WEDNESDAY], In doing so BACKUP 
copies the file MONDAY.DIR to [JAMES], copies the file TUESDAY.DIR 
to [JAMES.MONDAY], and copies the file WEDNESDAY.DIR 
to [JAMES.MONDAY.TUESDAY], Then BACKUP copies all 
files from [SAM.WORK.MONDAY.TUESDAY.WEDNESDAY] to 
[JAMES.MONDAY.TUESDAY.WEDNESDAY]. 

In a restore operation, the input specifier defaults to [*...] if the input 
save-set qualifier /SELECT is not used; this is important if you use the form 
[directory . . . ] in the output specifier. The function of the wildcard [*...] is 
to carry over the entire directory name from the first level on and to place it 
before the ellipsis in the output specifier. Thus, if the save set in the following 

be^WORKSAVE the ] director y tree [SAVE ... ], the restored directory tree will 

$ BACKUP MTAO:SAVE.BCK [WORK...] 

Note that the result will be the same, even if your output specifier has the same 
name as the directory in the input specifier, as shown in the following example: 

$ BACKUP MTAO:SAVE.BCK [SAVE...] 

The preceding command restores the directory tree [SAVE . . . ] to a directory 
tree named [SAVE.SAVE . . . ]. 

The following command restores the directory tree [SAVE . . . ] to a directory tree 
named [WORK ...,]: 

$ BACKUP MTAO:SAVE.BCK/SELECT=[SAVE...] [WORK...] 

There are two ways to retain the original directory name when you restore files. 
You must either use the form [*...] for the output specifier, or you must specify 
the input save-set qualifier /SELECT. The following example uses the form 
[*•••] in the output specifier to restore the directory tree [SAVE ] in save 
"set SAVE.BCK to the directory tree [SAVE . . . ]: 

$ BACKUP MTAO:SAVE.BCK [*...] 

The input save-set qualifier /SELECT causes only the ellipsis portion of the 
selected file specification to be carried over to the directory tree named in the 
output specifier [directory . . . ]. The following command restores [SAVE ] to 
[SAVE . . . ]: 

$ BACKUP MTAO:SAVE.BCK/SELECT=[SAVE...] [SAVE...] 
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By duplicating files or volumes of files, the Backup utility (BACKUP) protects 
data from loss or corruption. 

BACKUP is intended for use primarily by system managers and operators to 
protect public media. However, anyone can use BACKUP to make personal 
BACKUP copies and to transport files between OpenVMS systems. 

The two ways to back up your system disk are: 

• If you have access to the CD-ROM of the current version of OpenVMS Alpha 
or VAX, you can use a menu-driven procedure to back up your system disk. 

• If you do not have access to the CD-ROM of the current version of OpenVMS 
Alpha or VAX, you must use standalone BACKUP to back up your system 
disk. Standalone BACKUP is a version of the Backup utility that is 
bootstrapped into main memory instead of running under the control of 
the OpenVMS VAX operating system. Standalone BACKUP uses a subset of 
BACKUP qualifiers to perform image and physical BACKUP operations. 

Format 

BACKUP input-specifier output-specifier 

Parameters 
input specifier 

Specifies the input for the BACKUP operation. The input specifier can be a 
standard OpenVMS file specification, a BACKUP save-set specification, or a 
device name. If the input specifier is a save-set specification on disk, it must 
include the input save-set qualifier /SAVE_SET. 

DECnet node names are allowed only in save-set specifications. 

Wildcards are permitted in standard OpenVMS file specifications and in save-set 
specifications if they are on magnetic tape. 

output specifier 

Specifies the output for the BACKUP operation. The output specifier, like the 
input specifier, can be either a standard OpenVMS file specification, a BACKUP 
save-set specification, or a device name. If the output specifier is a save set on 
disk, it must include the output save-set qualifier /SAVE_SET. 

DECnet node names are allowed only in save-set specifications. 

You can use wildcard characters if the output specifier is a Files-11 volume. You 
cannot use wildcard characters if the output specifier is a BACKUP save set or a 
volume created by a BACKUP/PHYSICAL or BACKUP/IMAGE operation. Refer 
to Section 7.2.3 for restrictions on the use of wildcard characters in BACKUP 
commands. 
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Usage Summary 

To invoke online BACKUP, enter an appropriate BACKUP command at the DCL 
prompt. For instructions on invoking standalone BACKUP, refer to the OpenVMS 
System Manager’s Manual. 

When you enter a BACKUP command, BACKUP evaluates the input and output 
specifier and qualifiers to determine the type of operation to perform. BACKUP 
uses the input specifier to locate the input to the utility and directs output to 

the output specifier, which can be a file or a save set on disk or a save set on 
magnetic tape. 

After executing the command, BACKUP returns to DCL command level. If you 
want to halt the execution of a BACKUP command prematurely, press Ctrl/Y. If 
BACKUP is creating a file when you press Ctrl/Y, the file is closed immediately 
and only partially created. 

You need the user privilege TMPMBX to send messages to operator terminals 
when using BACKUP in batch mode. If you are performing a save operation to 
a volume set of sequential disks, you must have the user privilege PHY_IO or 
LOG_IO to write to a continuation volume. The use of several BACKUP qualifiers 
also requires privileges; these are noted in the appropriate qualifier descriptions. 
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BACKUP Qualifiers 

T his section describes and provides examples of each BACKUP qualifier. Make 
sure that you understand how the position of BACKUP qualifiers affects 
BACKUP operations. See Section 7.1 for information on the BACKUP command 
line format. Table 7-3 summarizes the BACKUP qualifiers. 


Table 7-3 BACKUP Qualifier Summary 

Qualifier Description 


/[NO] ALIAS 

/ASSIST 

/BACKUP 

/BEFORE 

/BLOCK_SIZE 

/BRIEF 

/BUFFER_COUNT 

/BY_OWNER 


/COMMENT 

/COMPARE 

/CONFIRM 

/CRC 


/CREATED 

/DELETE 

/DENSITY 

/EXACT_ORDER 


Specifies whether to maintain the previous behavior of multiple 

processing of alias and primary file entries. 

Allows operator or user intervention if a request to mount a 
magnetic tape fails during a BACKUP operation. 

Selects files according to the BACKUP date written in the file 
header record by the BACKUP/RECORD command. 

Selects files dated earlier than the date and time you specify. 

Specifies the output block size in bytes for data records in a 
BACKUP save set. 

Causes the /LIST qualifier to display the file specification, size 
(in blocks), and creation date for each file in the save set. 

This qualifier is obsolete and has no effect. 

As an input file-selection qualifier, /BY_OWNER causes 
BACKUP to process files owned by the specified UIC. 

As an output file qualifier, /BY_OWNER redefines the owner 
user identification code (UIC) for restored files. 

As an output save-set qualifier, /BY_OWNER specifies the 
owner user identification code (UIC) of the save set. 

Places the string that you supply into the BACKUP summary 
record of the output save set. 

Causes BACKUP to compare the contents of the first 
parameter with the contents of the second parameter. 

Displays prompts on your terminal for confirmation before 
processing each file. 

As an input save-set qualifier, /CRC checks the software cyclic 
redundancy check (CRC) encoded in the save set s data blocks. 

As an output save-set qualifier, /CRC specifies that the CRC 
is to be computed and stored in the data blocks of the output 
save set. 

Selects files according to the value of the creation date field in 
each file header record. 

Specifies that a BACKUP save or copy operation is to delete 
the selected input files from the input volume after all files 
have been successfully processed. 

Specifies the recording density of the output magnetic tape in 
bits per inch (bits/in). 

Specifies the exact order of tape volume labels that you want 
to use in a BACKUP operation. 


(continued on next page) 
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BACKUP Qualifiers 


Table 7-3 (Cont.) BACKUP Qualifier Summary 


Qualifier 

Description 

/EXCLUDE 

Excludes files from processing that otherwise meet the 
selection criteria for a save or copy operation. 

/EXPIRED 

Selects files according to the value of the expiration date field 
in each file header record. 

/FAST 

Processes the input specifier using a fast file scan to reduce 
processing time. 

/FULL 

Displays the information produced by the /LIST command 
qualifier in a format similar to that displayed by the DCL 
command DIRECTORY/FULL. 

/GROUP_SIZE 

Defines the number of blocks BACKUP places in each 
redundancy group. 

/IGNORE 

Specifies that a BACKUP save or copy operation will override 
restrictions placed on files or will not perform tape label 
processing checks. 

/IMAGE 

/INCREMENTAL 

Directs BACKUP to process an entire volume or volume set. 

Allows you to restore a disk volume from a series of 
incremental save sets. 

/INITIALIZE 

Initializes an output disk volume, making its entire previous 
contents unavailable. 

/INTERCHANGE 

Directs BACKUP to process files in a manner suitable for data 
interchange (software distribution) by excluding information 
that would prevent other utilities or sites from reading the 
BACKUP save set. 

/JOURNAL 

Specifies that a BACKUP save operation is to create, or append 
information to, a BACKUP journal file. 

/LABEL 

Specifies the 1- to 6- character volume labels for the magnetic 
tapes and 1- to 12- character volume labels for disks to which 
the save set is written. 

/LIST 

Lists information about a BACKUP save set and about the files 
in a save set. 

/LOG 

Displays the file specification of each file processed during the 
operation on SYS$OUTPUT. 

/MEDIA_FORMAT 

Controls whether data records are automatically compacted 
and blocked together. 

/MODIFIED 

Selects files according to the value of the modified date field 
(the date the file was last modified) in each file header record. 

/NEW_VERSION 

Creates a new version of a file if a file with an identical 
specification already exists at the location to which the file is 
being restored or copied. 

/OVERLAY 

Writes over an existing file when an identically named file is 
encountered during the restore operation. 

/OWNERJJIC 

The /OWNERJJIC qualifier has been superseded by the /BY 
OWNER qualifier. Digital recommends that you substitute 
/BY.OWNER for OWNERJJIC in command procedures and 
operator instructions. See the description of the /BY OWNER 
qualifier for more information. 

(continued on next page) 
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BACKUP 


Table 7-3 (Cont.) BACKUP Qualifier Summary 


Qualifier 

Description 

/PHYSICAL 

Specifies that a BACKUP operation is to ignore any file 
structure on the input volume and to process the volume in 
terms of logical blocks. 

/PROTECTION 

When you create a save set on disk, this qualifier defines 
the protection to be applied to an output save set. When you 
create a save set on magnetic tape, this qualifier defines the 
protection to be applied to the magnetic tape volume. 

/RECORD 

Records the current date and time in the BACKUP date field 
of each file header once a file is successfully saved or copied. 

/RELEASE TAPE 

Dismounts and unloads a tape after a BACKUP save operation 


either writes and verifies the save set, or reaches the end of 
the tape. 

/REPLACE 

Replaces a file on the output specifier with an identically 
named file from the input specifier. 

/REWIND 

As an input save-set qualifier, /REWIND rewinds the input 
tape reel to the beginning-of-tape marker before reading the 
input volume. 

As an output save-set qualifier, /REWIND rewinds the output 
tape to the beginning-of-tape marker and initializes the output 
tape. 

/SAVE_SET 

As an input save-set qualifier, /SAVE_SET directs BACKUP to 


treat the input file as a BACKUP save set. 

As an output save-set qualifier, /SAVE_SET directs BACKUP 
to treat the output file as a BACKUP save set. 

/SELECT 

Selects the specified files for processing. 

/SINCE 

Selects files dated equal to or later than the specified date and 
time. 

/TAPE_EXPIRATION 

Writes a file expiration date other than the current date to the 


file header label of the save set. 

/TRUNCATE 

Controls whether a copy or restore operation truncates a 
sequential output file at the end-of-file (EOF) when creating it. 

/VERIFY 

Specifies that the contents of the output specifier be compared 
with the contents of the input specifier after a save, restore, or 
copy operation is completed. 

/VOLUME 

Indicates that a specific disk volume in a disk volume set is to 
be processed. 




/ALIAS 

Command Qualifier 

Specifies that the previous behavior of multiple processing of alias and primary 
file entries be maintained. 

Format 


/ALIAS save-set-spec 

/NOALIAS 
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BACKUP 

/ALIAS 


Description 


The /ALIAS qualifier maintains the previous BACKUP behavior of treating alias 
file entries the same as primary file entries. Therefore, a primary file may be 

processed multiple times by BACKUP if one or more alias file entries reference 
the same primary file entry. 

If you specify /NOALIAS, alias directory and file entries are ignored. Therefore 
multiple processing of primary files may be avoided, which saves time and save 
set file space. If a restore operation is performed using the /ALIAS qualifier but 

SLT’ m,\T? a TJ by “ S ” g the /N0ALIAS a message is displayed 

that the /ALIAS qualifier will be ignored. 


/ASSIST 


Format 


Command Qualifier 

Allows operator or user intervention during a BACKUP operation if a magnetic 
tape mount request fails or if an operation requires another volume. 

/[NO]ASSIST input-specifier output-specifier 


Description 


The /ASSIST qualifier causes BACKUP to send messages to operator terminals 
when a failure occurs during a BACKUP mount request or when an operation 
requires another volume. BACKUP sends messages to operator terminals enabled 
to receive TAPES and CENTRAL messages. (See the description of the REPLY 
command in the OpenVMS DCL Dictionary for information about enabling and 
disabling operator terminals.) If a failure occurs, the operator can either abort 
the operation or correct the error condition and allow the operation to continue. 

If no operator terminal is enabled to receive TAPES and CENTRAL messages 
and to respond to a mount assist request, a message is displayed informing the 
user of the situation. If a volume is placed in the requested drive, no additional 

? P o r ^°L? T ^ T S ® iS neCeSSary ' ^ operator reply to a mount request is written 
to SYS$OUTPUT. When BACKUP is run interactively, SYS$OUTPUT is the 
user’s terminal. When BACKUP is run in batch mode, SYS$OUTPUT is the 
batch job log file. 

If you specify /NOASSIST, mount messages appear on your terminal and are not 
sent to the operator. 

Jv^ d / f n, U r 1 L i ^l SSIST - The /N0ASSIST Qualifier has no effect if the logical name 
SYS$COMMAND points to a device that is not a terminal (as is the case when 
you run BACKUP in a batch job). Specifying /NOASSIST when BACKUP is run 
in batch mode has no effect. 
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BACKUP 

/ASSIST 


Example 

$ BACKUP/NOASSIST [PAYROLL]*.*;* MTAl: PAYROLL.BCK/LABEL=WKY101 

This command mounts the volume labeled WKY101 on the MTAl tape drive and 
copies all files in the [PAYROLL] directory to a save set named PAYROLL.BCK. 
The /NOASSIST qualifier directs BACKUP to send mount messages to your 
terminal rather than to the operator terminal. The WKY101 label indicates that 
WKY101 is a weekly BACKUP tape in group 1, volume number 01. (If the volume 
label of the tape is not WKY101, you can direct BACKUP to write the save set to 
the tape by choosing the OVERWRITE option at the BACKUP> prompt.) 


/BACKUP 


Input File-Selection Qualifier 

Selects files according to the BACKUP date written in the file header record by 
the BACKUP/RECORD command. 


Format 

input-specifier/BEFORE=time/BACKUP output-specifier 
input-specifier/SINCE=time/BACKUP output-specifier 

Description 

The /BACKUP qualifier is valid with Files-11 Structure Level 2 volumes only 
and must be used with either the /BEFORE or /SINCE qualifier. You cannot use 
/BACKUP with the /CREATED, /MODIFIED, or /EXPIRED qualifiers in an image 
operation or in a physical operation. 

The /BACKUP qualifier selects files by comparing the date and time recorded in 
the BACKUP field of the file header record with the date and time specified with 
the /BEFORE or /SINCE qualifier. The date and time recorded in the file header 
record is the date and time the file was last saved or copied using the /RECORD 
command qualifier. 

When you use /BACKUP with /BEFORE, files with a BACKUP date prior to the 
specified date or time are selected. Files with no BACKUP date (/RECORD was 
not specified when the file was saved or copied) are also selected. 

When you use /BACKUP with /SINCE, files with a BACKUP date equal to or 
later than the specified date or time are selected. Files with no BACKUP date 
(/RECORD was not specified when the file was saved or copied) are also selected. 

Examples 

1. $ BACKUP/RECORD 

_From: [PAYROLL]*.*;*/BEFORE=01-SEP-1994/BACKUP 
_To: MTAl:SEP01.BCK 

In this command, the /BACKUP qualifier combined with the /BEFORE 
qualifier saves all versions of all files in the directory [PAYROLL] that have 
a BACKUP date written before September 1, 1994. The command qualifier 
/RECORD writes the date and time of the save operation to the file header 
record of each saved file. 
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BACKUP 

/BACKUP 


2. $ BACKUP/RECORD [ACCOUNTS...]/SINCE=YESTERDAY/BACKUP MTA1:ACC.BCK 

In this command, the /BACKUP qualifier combined with the /SINCE qualifier 
saves all files in all subdirectories of [ACCOUNTS] that have a BACKUP date 
written since yesterday (24 hours before midnight last night). The command 
qualifier /RECORD writes the date and time of the save operation to the file 
header record of each saved file. 


/BEFORE 


Input File-Selection Qualifier 

Selects files dated earlier than the date and time you specify. 

Format 

input-specifier/BEFORE=time output-specifier 

Description 

The /BEFORE qualifier selects files by comparing the date and time in the 
specified field of each file header record with the date and time you specify in the 
command line. The following list shows the other input file-selection qualifiers 
you can use with /BEFORE and their functions. Use these other qualifiers only 
one at a time in your command line. 

Selects files last saved or copied by BACKUP/RECORD 
before the date specified. Also selects files with no BACKUP 
date. 

Selects files created before the date specified. 

Selects files that have expired as of the date specified. 

Selects files last modified before the date specified. If you 
specify /BEFORE without another qualifier, /MODIFIED is 
used by default. 

Specify the date and time as a delta time or as an absolute time using the format 
[dd-mmm-yyyy[.]][hh:mm:ss.cc]. You can also use one of the following reserved 
words to specify the date and time: 

BACKUP The BACKUP date of the file written by a previous BACKUP 

/RECORD operation (available only on Files-11 Structure 
Level 2 volumes) 

TODAY The current day, month, and year at 00:00:00.0 o’clock 

TOMORROW 24 hours after midnight last night 
YESTERDAY 24 hours before midnight last night 

The /BEFORE qualifier is not valid in incremental restore operations. 

Example 

$ BACKUP [POLICIES]*.*;*/BEF0RE=T0DAY/EXPIRED DMA1:0LDP0L.BCK/SAVE_SET 

This command saves all files in the directory [POLICIES] that have expiration 
dates preceding today’s date. 


/BACKUP 


/CREATED 

/EXPIRED 

/MODIFIED 
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BACKUP 

/BLOCK_SIZE 


/BLOCK_SIZE 

Output Save-Set Qualifier 

Specifies the output block size in bytes for data records in a BACKUP save set. 

Format 

input-specifier output-save-set-spec/BLOCK_SIZE=n 

Description 

You can specify a block size between 2048 and 65,535 bytes. BACKUP may 
adjust this value according to the constraints of the BACKUP format. Although 
BACKUP may adjust the block size you specify, it does not adjust the block size 
over the maximum of 65,535. 

If you specify /BLOCK_SIZE in a magnetic tape save operation, BACKUP ignores 
any block size defined by the /BLOCK_SIZE qualifier to the DCL command 
MOUNT. 

If the block size is set to a large value for a save set on magnetic tape, it is 
possible for the magnetic tape to run off its reel or for a large number of write 
errors to be logged. If this occurs, avoid using large block sizes. If the problem 
recurs with the same magnetic tape, avoid using that tape for future BACKUP 
operations. 

The default block size for magnetic tape is 8192 bytes; the default for disk is 
32,256 bytes. 

Example 

$ BACKUP/RECORD DRA2:[LEE...]/SINCE=BACKUP MTAO :SAVEWORK.BCK/BLOCK_SIZE=10000 

This command saves a directory tree on DRA2 to a magnetic tape mounted 
on drive MTAO. The input file-selection qualifier /SINCE=BACKUP instructs 
BACKUP to process only those files in the specified directory tree that have 
been modified since the last BACKUP/RECORD operation. The output save- 
set qualifier /BLOCK.SIZE directs BACKUP to assign a block size of 10,240 
(BACKUP rounds the specified block size of 10,000 up to the next multiple of 
512). 


/BRIEF 

Command Qualifier 

Lists the file specification, size, and creation date for each file in the save set. 
(The size listed is the actual size of the file saved, rather than the number of 
blocks allocated to the file.) The /BRIEF qualifier is valid only with the /LIST 
qualifier and is the default format for BACKUP listings. Specify the /FULL 
qualifier to list the information in a format similar to that displayed by the DCL 
command DIRECTORY/FULL. 
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BACKUP 

/BRIEF 


Format 

/LIST/BRIEF save-set-spec 


Example 


$ BACKUP/LIST/BRIEF DBA2:[SAVE]23MAR95.BCK/SAVE_SET 
Listing of save set(s) 


Save set: 

Written by: 

UIC: 

Date: 

Command: 

Operating system: 


23MAR95.BCK 

MOROCI 

[ 000200 , 000200 ] 

23-MAR-1995 14:18:16.96 

BACKUP [SAVE] DBA2:[SAVE]23MAR95.BCK/SAVE_SET 
VAX/VMS version 6.2 


BACKUP version: V6.2 

CPU ID register: 08000000 

Node name: _SUZI:: 

Written on: _DBA2: 

Block size: 32,256 

Group size: 10 

Buffer count: 3 


[SAVE]INFO.TXT;4 
[SAVE]LAST.DAT;1 
[SAVE]WORK.DAT;3 

Total of 3 files, 39 blocks 
End of save set 


5 4-FEB-1995 13:12 

1 18-JAN-1995 14:11 

33 l-JAN-1995 10:02 


This command lists the BACKUP summary information and the file name size 
and creation date for each file in the save set. Note that the input save-set 

qualifier /SAVE_SET is required to identify the input specifier as a save set on a 
Files-11 medium. 


/BUFFER COUNT 


Command Qualifier 

This qualifier is obsolete. You can still specify the /BUFFER_COUNT qualifier, 
although it has no effect. (This ensures that command procedures containing this 
qualifier will still operate correctly.) Digital recommends that you remove the 
/BUFFER_COUNT qualifier from command procedures. 


/BY OWNER 

Input File-Selection Qualifier 

Selects files for processing according to the user identification code (UIC). 

Format 

input-specifier/BY_OWNER[=[uic]] output-specifier 
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/BY_OWNER 


Description 

If you specify /BY.OWNER without a UIC, BACKUP selects all files whose UIC 
matches that of the current process. 

Specify either a numeric UIC as octal numbers or an alphanumeric UIC in the 
form [g,m], Wildcards are permitted. Note that the brackets are required. 

[g,m] 

g An octal number in the range 0 to 37776 representing the group number 
or an alphanumeric group name 

m An octal number in the range 0 to 177776 representing the member 
number or an alphanumeric member name 

If you do not specify /BY_OWNER, BACKUP processes all files specified by the 
input specifier. 

Examples 

1 $ BACKUP [SNOW...]/BY_OWNER MT$DRIVE: SNOW. BCK/LABEL=TAPE01 

In this example, BACKUP mounts the tape with the label TAPEOi on drive 
MT$DRIVE and saves all files in the directory and subdirectories of [SNOWJ 
with the UIC of the current default process to the save set SNOW.BCK. 

2. $ BACKUP [SUNDANCE]/BY_OWNER=[727,46] DBA1:STABLE.BCK/SAVE.SET 

In this example, all files in the directory [SUNDANCE] with an owner UIC of 
[727,46] are saved to the sequential-disk save set STABLE.BCK on DBA1. 


/BY_OWNER 

Output File Qualifier 

Redefines the owner user identification code (UIC) for restored files. 


Format 

input-specifier output-specifier/BY_OWNER[=option] 

Description 

The following are available options: 

DEFAULT Sets the owner UIC to the user’s current default UIC. This 

option is the default if you do not specify the /BY_OWNER 
qualifier, except in image and incremental restore operations, 
when ORIGINAL is the default option. 

ORIGINAL Retains the owner UIC of the file being restored. This option 

is the default if you specify the /BY_OWNER qualifier with 
no option. This option is also the default for incremental 
restore operations. To use this option, the UIC must be 
yours, or you must have the SYSPRV user privilege or be the 
owner of the output volume. 
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/BY_OWNER 


Example 


PARENT 


tuic] 


Sets the owner UIC to the owner UIC of the directory to 
which the file is being restored or copied. To use this option, 
the parent UIC must be yours, or you must have the SYSPRV 
user privilege or be the owner of the output volume. 

Sets the owner UIC to the UIC specified. Use the [g,m] 
format (as described in the input file-selection qualifier /BY_ 
OWNER). To use this option, the UIC must be yours, or you 
must have the SYSPRV user privilege or be the owner of the 
output volume. 


In restore operations where the command qualifier /IMAGE or /INCREMENTAL 
is specified, the default is /BY_OWNER=ORIGINAL. 


$ BACKUP DBA2:ACCOUNTS.BCK/SAVE_SET [CLEAVER...]/BY_0WNER=PARENT 

In this example, the sequential-disk save set ACCOUNTS.BCK is restored to the 

mr™i r f e , [CLEAVER...], assigning each restored file the owner UIC of the 
[CLEAVER] directory. 


/BY OWNER 

Output Save-Set Qualifier 

Specifies the owner user identification code (UIC) of the save set. 

Format 

input-specifier output-save-set-spec/BY_OWNER=uic 

Description 

If the /BY_OWNER qualifier is omitted, the UIC of the current process is used. 
To use this qualifier on Files-11 save sets, you need the user privilege SYSPRV 
or the UIC must be your own. 

Specify either a numeric UIC as octal numbers or an alphanumeric UIC in the 
form [g,m]. Wildcards are permitted. Note that the brackets are required. 

[g,m] 

g An octal number in the range 0 to 37776 representing the group number 
or alphanumeric group name 

m An octal number in the range 0 to 177776 representing the member 
number or alphanumeric member name 

Example 


$ BACKUP [CLEAVER...] MFA2:ACCOUNTS.BCK/BY_OWNER=[301,310]/LABEL=TAPE01 

In this example, BACKUP mounts the tape with the label TAPE01 on drive 
MFA2. Next, BACKUP saves the directory tree [CLEAVER...] to a save set 
named ACCOUNTS.BCK. The output save-set qualifier /BY_OWNER assigns an 
owner UIC of [301,310] to the save set. 
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/COMMENT 


/COMMENT 

Format 

Example 


Output Save-Set Qualifier 

Places a comment in an output save set. If the comment string is longer than 
one word or if it contains nonalphanumeric characters, you must enclose it 
in quotation marks (" ■). A DCL command can contain a maximum of 1024 
characters. 


input-specifier output-save-set-spec /COMMENT=string 


$ BACKUP [REMARKS] DMAl:20JULREM.BCK/SAVE_SET - 
_$ /C0MMENT="Remote operations for July 20, 1995" 
$ BACKUP/LIST DMAl:20JULREM.BCK/SAVE_SET 
Listing of save set 


Save set: 
Written by: 
UIC: 

Date: 

Command: 

operations 


20JULREM.BCK 

WALRUS 

[360,054] 

20-JUL-1995 15:22:06.62 

BACKUP [REMARKS] DMAl:20JULREM.BCK/SAVE_SET/COMMENT-Remote 
for July 20, 1995 


Operating system: VMS Version V6.2 


BACKUP version: 
CPU ID register: 
Node name: 
Written on: 
Block size: 
Group size: 
Buffer count: 


V6.2 

0138084C 
_ABBEY:: 
_ABBEY$DMA1: 
32256 
10 
3 


[REMARKS]BAC.RES;1 
[REMARKS]COM.LIS;1 
[REMARKS]DTOP.DIR;1 


2 20-JUL-1995 14:13 
1 20-JUL-1995 14:04 
1 20-JUL-1995 14:18 


Total of 40 files, 535 blocks 
End of save set 

The first BACKUP command saves the directory [REMARKS] to a sequential-disk 
save set and records a comment. The BACKUP/LIST command displays the 
contents of the newly created save set. Note that the /SAVE_SET qualifier is 
required when creating a save set on disk. 
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/COMPARE 


Format 


Command Qualifier 

Compares the sav e set, device, file, or files specified by the first parameter with 
the contents of the Files-11 device, file, or files specified by the second parameter 
and displays an error message if it finds a difference. 


/COMPARE file-spec file-spec 
/COMPARE save-set-spec file-spec 
/IMAGE/COMPARE device-spec device-spec 
/IMAGE/COMPARE save-set-spec device-spec 
/PHYSICAL/COMPARE device-spec device-spec 
/PHYSICAL/COMPARE save-set-spec device-spec 

Description 


In a BACKUP compare operation, the first parameter can be a Files-11 file or 
a wildcard character representing a set of files, a BACKUP save set on disk or 
magnetic tape a tape device, or a disk device. The second parameter must be a 
I des il disk file, a wildcard character representing a set of files or a Files-11 
disk device, unless you specify the command qualifier /PHYSICAL. When you 
specify /PHYSICAL, and the first parameter specifies a disk device, both disks in 
the compare operation must be mounted with the /FOREIGN qualifier. 

BACKUP displays the following error message if it encounters a difference 
between files it compares: 

%BACKUP-E-VERIFYERR, verification error for 

Use the /COMPARE qualifier to compare a save set with original files or to 

r?^ fileS ° r voIumes c °P ied usin & BACKUP with original files. Because 
BACKUP processes files by blocks, comparing files not produced by BACKUP is 
likely to cause mismatch errors in files that are apparently identical. 

If you do not specify a version number with the file specification, the default is •* 
(the asterisk wildcard character), which processes all versions of the file. 

Both parameters in a compare operation are input specifiers. 

If you are comparing two entire Files-11 volumes, use an image compare 
operation, as follows: 

$ BACKUP/IMAGE/COMPARE DBA1: DBA2: 

You cannot use the command qualifier /DELETE or /RECORD in compare 
operations. 

Do not perform compare operations on files that were restored or copied using 

the output file qualifier /NEWVERSION because this qualifier causes version 
numbers to change. 
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/COMPARE 


Examples 

1. $ BACKUP/COMPARE JAZZ.DAT BLUES.DAT 

This example compares two Files-11 files. Because no version number is 
specified, BACKUP compares all versions of each file. 

2. $ BACKUP/COMPARE/IMAGE MTAO:SWING.BCK DBA2: 

This example compares an image save set stored on magnetic tape and a 
Files-11 volume. 


/CONFIRM 



Input File-Selection Qualifier 

Displays prompts on your terminal for confirmation before processing each file. If 
you want the file to be processed, enter Y or YES and press Return. 

Format 

input-specifier/CONFIRM output-specifier 

Example 

$ BACKUP *.LIS/CONFIRM/LOG DLA2:LIST.BCK/SAVE_SET 

DISK$DEFAULT:[WONDER]CRE.LIS;1, copy? (Y or N): Y 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]CRE.LIS;1 

DISKSDEFAULT:[WONDER]CRETIME.LIS;1, copy? (Y or N): Y 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]CRETIME.LIS;1 

DISK$DEFAULT:[WONDER]EXC.LIS;1, copy? (Y or N): Y 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]EXC.LIS;1 

DISK$DEFAULT:[WONDER]REB.LIS;1, copy? (Y or N): N 

DISK$DEFAULT:[WONDER]SETREB.LIS;1, copy? (Y or N): Y 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]SETREB.LIS;1 

DISK$DEFAULT:[WONDER]VERS.LIS;1, copy? (Y or N): N 


$ 

This command locates all files with a file type of .LIS and prompts for 
confirmation before saving each file to LIST.BCK on DLA2. The command 
qualifier /LOG displays information about each file as it is processed. Note that 
you must use the output save-set qualifier SAVE_SET when creating a save set 
on disk. 
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/CRC 


Input Save-Set Qualifier 

Specifies that the software cyclic redundancy check (CRC) is to be performed. 

Format 


Example 


input-save-set-spec/[NO]CRC output-specifier 


Description 


/T?nppp Ul V S /CRC ' T ° disable CRC check ing, specify /NOCRC; note that use of 
/JNUCKC reduces processing time but increases the risk of data loss. 


$ BACKUP MTA2:928SAVE.BCK/NOCRC [] 

This command restores the save set 928SAVE.BCK to the current default 
directory, indicated by ([]); the input save-set qualifier /NOCRC disables CRC. 


/CRC 


Format 


Output Save-Set Qualifier 


Specifies whether the software cyclic redundancy check (CRC) 
and stored in the data blocks of the output save set. 


is to be computed 


input-specifier output-save-set-spec/[NO]CRC 

Description 

The default is /CRC. To disable checking, use /NOCRC; note that use of/NOCRC 
reduces processing time but increases the risk of data loss. 

Example 


$ BACKUP/RECORD []/SINCE=BACKUP MTA2:928SAVE.BCK/NOCRC 

This command saves all files in the current default directory that have been 
Sin “ the last BACKUP/KECORD operation to the save set 
checkin^' BCK; the ° UtPUt S3Ve ' Set qualifier /NOCRC disables cyclic redundancy 
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/CREATED 


Input File-Selection Qualifier 

Selects files according to the value of the creation date field in each file header 
record. 


Format 

input-specifier/BEFORE=time/CREATED output-specifier 
input-specifier/SINCE=time/CREATED output-specifier 


Description 


You must use either the /BEFORE qualifier or the /SINCE qualifier with 
/CREATED. The date and time you specify with /BEFORE or /SINCE determine 
which files should be processed. 


You cannot use /CREATED with the /BACKUP, /MODIFIED, or /EXPIRED 
qualifiers. 


Example 

$ BACKUP *.SDML/SINCE=YESTERDAY/CREATED DLA2:[SAVEDIR]/SAVE_SET 

The command in this example saves all files with a file type of .SDML created 
since yesterday (24 hours before midnight last night). 


/DELETE 


Command Qualifier 

Specifies that a BACKUP save or copy operation is to delete the selected input 
files from the input volume after all files have been successfully processed. 

Format 

/DELETE file-spec save-set-spec 


Description 

The /DELETE qualifier is valid only when used in a BACKUP save or copy 
operation. You must have sufficient privilege to delete files; if you do not, files 
protected against deletion are not deleted. If you use the command qualifier 
/VERIFY with /DELETE, files that fail verification are not deleted. 

You cannot use /DELETE with the /RECORD or /COMPARE command qualifiers. 


Examples 

1 $ BACKUP/DELETE BOP.DAT MTAO:BOP.BCK/LABEL=DANCE 

In this example, the file BOP.DAT will be deleted after the save set BOP.BCK 
is successfully created on MTAO. 
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2 . 


$ BACKUP/VERIFY/DELETE RAY.DAT, JOE.DAT,ELLA.DAT MTAO:OSCAR.BCK/LABEL=FRIEND 

The BACKUP command deletes the selected list of files in this example after 
saying them to OSCAR.BCK on MTAO and comparing the output save set 
with the input files. If BACKUP detects a difference between the contents of 
the output save set and the input file, the input file is not deleted. 


/DENSITY 


Format 


Description 


Example 


Output Save-Set Qualifier 

fin^You ' h ,?J eC ° rdi ? g i enSi ! y ° f the ° Utput magnetic ta P e in bi ts per inch (bits 
/in;. You must specify the output save-set qualifier /REWIND with /DENSITY. 


input-specifier output-save-set-spec/DENSITY=n 


The value that you specify must be supported by your magnetic tape hardware, 
tape dri™ 1 * ^ qUahfier ’ the default densit y is the current density on the output 

LwmlTv - ! iS inC i ,mpatibIe with the out P ut ^ve-set qualifier 
/NOREWIND. You must specify the output save-set qualifier /REWIND to 

initialize the magnetic tape when using the /DENSITY qualifier When vou 

® ACKUP “ ‘»e tapel the be^nS-tape. 
, ± * P imtiaIlzes the tape with the new density, removing access to all 

data that previously resided on the tape. 


$ BACKUP UPAS MTA2:SAVEPAS.BCK/DENSITY=1600/REWIND/LABEL=PASCAL 

The magnetic tape on drive MTA2 is initialized. All files with a file type of .PAS 
ia ^be current default directory are saved to the save set SAVEPAS.BCK. The 
/DENSITY qualifier sets the recording density to 1600 bits/in. 

/EXACT ORDER 


Output Save-Set Qualifier 

P® p f^ dmg on the a i her qualifiers you specify on the command line, the /EXACT 
UKDEK qualifier allows you to do the following: 

* ? P ^S T ? e 6Xact ° rder of tape volume labels that y° u want to use in a 
-BACKUP operation. 

• Preserve the existing volume label on a tape. 

Prevent previous volumes of a multivolume save operation from being- 
overwritten. 6 
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Format 


input-specifier output-save-set-spec/EXACT_ORDER 


Description 


The /EXACT_ORDER qualifier allows you to do the following: 

• Specify the exact order of tape volume labels that you want to use in a 
BACKUP operation. You must use the /LABEL=(labell,label2,...) quail er 
to specify the order of the labels. BACKUP continues the operation as long 
as the label of the tape in the drive matches the corresponding label on the 
command line. If you do not specify enough labels on the command line to 
complete the operation, BACKUP prompts you to enter a label for the tape in 

the drive. 

• Preserve the existing volume label on a tape. If you do not use the /L^ EL 
qualifier on the command line and the tape has an ANSI label, BACKUP uses 

the existing label. 

• Prevent previous volumes of a multivolume save operation from being 
overwritten. BACKUP keeps track of the volume labels you have already 
used in the operation. If you accidently mount one of the previous volumes, 
BACKUP displays the following error message: 


%BACKUP-W-MOUNTERR, volume 1 on MKB100: was not mounted because 
its label does not match the one requested 

Volume with label TAPEl was already used in this save operation 
specify option (QUIT or NEW tape) 

BACKUP> 


Note the following restrictions when you use the /EXACT.ORDER output 
qualifier: 

• If you use the /EXACT.ORDER qualifier, you cannot specify a label longer 
than six characters on the command line. If you specify a label longer than 
six characters, BACKUP displays the following error message: 


%BACKUP-F-INVQUAVAL, value 'label.name' invalid for /LABEL qualifier 

• You cannot use the /IGNORE=LABEL_PROCESSING qualifier with the 
/EXACT.ORDER qualifier. 

• You cannot use /REWIND as an output qualifier with the /EXACT.ORDER 
qualifier. 

• If you use the /LABEL qualifier with the /EXACT.ORDER qualifier, you 
cannot specify duplicate labels. 


Examples 

1 $ BACKUP/IMAGE/RECORD/VERIFY/NOASSIST 

ZtoTmKBIOO:MAR 11.SAV/LABEL=(TAPEl,TAPE2,TAPE3)/EXACT.ORDER 

This example uses the /EXACT.ORDER qualifier to specify the exact order of 
labels for the BACKUP operation. Note that if you specify the /Abblbl 
qualifier, BACKUP would display messages on the operator terminal. 
BACKUP does the following: 

a. Compares the volume label of the tape in MKB100: with the first label 
that you specified on the command line (TAPEl). If the labels mate 
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d. 


2 . 


exaciiy, BACKUP begins the save operation. If the labels do not match or 
message 56 d ° eS ^ ^ “ ANSI 1&be1 ’ BACKUP displays the following 

%BAC K UP-W-MO UNT E R R, volume 1 on MKB100: was not mounted because 
its label does not match the one requested 
%BACKUP-W-EXLABEER, volume label processing failed because 
volume TAPE4 is out of order, Volume label TAPE1 was expected 

“ tape ' 0WRm ™ tape ' 0SE loaded <**) 

j® ° n th ! If 10 : 1 ,'™" specify > you can ‘he backup operation 
iu i u dlsmount the old tape and mount a new one (NEW), overwrite 
the label and the data on the tape (OVERWRITE), or write the data to 
the tape using the loaded tape’s label (USE). 

b. When the operation fills the first tape, it displays the following message: 

%BACKUP-I-RESUME, resuming operation on volume 2 

%BACRUP-I-READYWRITE, mount volume TAPE2 on MKB100: for writina 
Respond with YES when ready: writing 

c. When you load the second tape and enter YES, BACKUP compares 
the label of the second tape with the second label you specified on the 
command line (TAPE2) just as it did in step la. 

Assuming the volume labels match, BACKUP continues processing until 
it completes the operation or runs out of volume labels. If you do not 

u P A e ^ T e ^° Ugh labels ° n the command Iine to complete the operation, 
BACKUP prompts you to enter a label for the tape in the drive as follows: 

%BACRUP-W-MOUNTERR, volume 4 on MKB100: was not mounted because 
the label was not specified 

specify EXACT_ORDER label (up to 6 characters) 

BACKUP> 

BACKUP then compares the label on the tape with label you specify as 
described previously. 

$ backup/image/record/verify/noassist 

_From: DKA100:[TEST] 

-To: MKB100:MARI1.SAV/EXACTJDRDER 

Because this example does not use the /LABEL qualifier, BACKUP uses the 
existing label on the tape. If the tape does not have an ANSI label, and it is 
the first tape in the operation, BACKUP displays the following error message: 

%BACKUP-F-NOTANSI, tape is not valid ANSI format 

If the tape does not have an ANSI label, and is not the first tape in the 
operation, BACKUP displays the following error message prompting you to 
specify a label: 

%BACKUP-W-MOUNTERR, volume 2 on MRB100: was not mounted because 
tne label was not specified 

specify EXACT_ORDER label (up to 6 characters) 

BACRUP> 
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Note 


BACKUP checks to make sure you specify a valid label. If the labe is 
not valid (for example, longer than six characters), BACKUP displays an 
error message. In previous versions of the OpenVMS operating system, 
BACKUP truncated long volume labels. 


/EXCLUDE 


Input File-Selection Qualifier 

Excludes files that otherwise meet the selection criteria for a save or copy 
operation. The excluded files are not processed. 


Format 

input-specifier/EXCLUDE=(file-spec[,...]) output-specifier 


Description 


If you specify more than one file, separate the file specifications with commas an 
enclose the list in parentheses. Do not use a device specification when defining 
the files to be excluded. You can use most standard wildcard characters, but 
you cannot use wildcard characters denoting latest versions of files (;) or relative 
versions of files (;-n). 


Note that BACKUP does not apply temporary file specification defaults within 
the list. Each file specification independently takes its defaults from the file 
specification [000000 . . . ]*.*;*. 


If you specify directory files (files with the file type .DIR), your command is 
processed but the directory files are not excluded (they are processed). BACKUP 
uses directory files to facilitate incremental restore operations. 

You cannot use the /EXCLUDE qualifier in image restore operations. 


Example 

$ BACKUP (J . . MJlT , 

_From: DRA2 : [ CONTRACTS ] / BEF0RE=T0DAY / EXCLUDE= ( . OBJ, . MAI) 

_To: MFAO:CONTRACT.BCK/LABEL=DLY102 

All files in the directory [CONTRACTS] that have a modification date prior to 
today (the current day, month, and year at 00:00:00.0 o’clock) are saved to the 
save set CONTRACT.BCK on drive MFAO, except for those with a file type ot 
.OBJ or .MAI. 
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Input File-Selection Qualifier 


record 8 filGS aCC ° rding t0 the VaIue of the ^P^ation date field in each file header 

Format 

input-specifier/BEFORE=time /EXPIRED output-specifier 
input-specifier/SINCE=time /EXPIRED output-specifier 

Description 

™ ust use tlle mput file-selection qualifier /BEFORE or /SINCE with 

vu^ D ' The date and time you s P ecif y to /BEFORE or /SINCE determines 
which files are processed. 

SaroKSn'* 1 ‘ he input * le ' selection '> ualmers backup, 

Example 

$ BACKUP [CONTRACTS]/BEF0RE=T0M0RR0W/EXPIRED MTA1:3ODEC.BCK/LABEL=WK04 

This command saves all files in the directory [CONTRACTS] that have an 
3SS 30DECJ3CK. t ° m0rr0w (24 h °™ midnight last night) to a save 


/FAST 


Format 


Command Qualifier 


Processes the input specifier using a fast file 
input specifier must be a Files-11 disk. 


scan to reduce processing time. The 


/FAST input-specifier output-specifier 

Description 


The fast file scan reads the index file on the Files-11 disk specified by the input 
specifier and creates a table of files that match the qualifiers you specified. 


When you use the /FAST qualifier to save a disk, ALIAS directory trees are not 
processed. Only the primary files that the ALIAS points to are saved. Depending 
on the number of ALIAS directory specifications there are on the disk, this 
may increase performance by reducing the number of files BACKUP checks for 

processing. A message is displayed for each ALIAS directory or file that is not 
processed. 


To perform a fast file scan, you need write access to the INDEXF.SYS file on the 
input medium, or the input medium must be write-locked. This requirement 
is necessary because BACKUP opens the index file to synchronize with the file 
system, whether or not any update is made. 
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A fast file scan is most useful when the input specifier includes most of the files 
on the volume, and file-selection qualifiers (such as those that pertain to date or 
owner) specify a relatively small set of the files named. Because image operations 
implicitly use the fast file scan, the /FAST qualifier is ignored if used with the 
command qualifier /IMAGE. 

You cannot use /FAST in restore operations. 


Example 


$ BACKUP/FAST 

_From: DBA1:[*...]/MODIFIED/SINCE=TODAY 
_To: MTAO:13N0VBAK.BCK,MTAl:/LABEL=WK201 


In this example all files on the disk DBA1 that have been modified today are 
laved to a mSreel tape save set named 13NOVBAK.BCK. The /FAST quahSer 
is used to reduce processing time. 


/FULL 


Command Qualifier 

Lists the file information produced by the command qualifier /LIST in the format 
provided by the DCL command DIRECTORY/FULL. 

Format 

/LIST/FULL input-specifier [output-specifier] 

Description 

The /FULL qualifier is valid only with the command qualifier /LIST. 

If you do not specify /FULL with /LIST, the /LIST qualifier uses the default 
command qualifier /BRIEF and lists only the file specification, size, and creation 
date of each file. When you specify /FULL, the list includes more information 
from the file header records, such as the BACKUP date, date of last modification, 
number of blocks allocated to the file, file protection and organization, and record 
attributes. 


Example 


$ BACKUP/LIST/FULL MTAl:ROCK.BCK 
Listing of save set(s) 


Save set: 
Written by: 
UIC: 

Date: 

Command: 


ROCK.BCK 
RINGO 

[000200,000300] 

20-AUG-1995 15:39:38.89 

BACKUP [.STONES] MTAO:ROCK.BCK/LABEL=BACKUP 


Operating system: VAX/VMS version 6.2 
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BACKUP version: 

V6.2 

CPU ID register: 

08000000 

Node name: 

_SUZI:: 

Written on: 

MTA0: 

Block size: 

8192 

Group size: 

10 

Buffer count: 

30 

[RINGO.STONES]GRAPHITE.DAT;1 
Size: 


1/1 

Owner: [000200,000200] 
File ID: (91,7,1) 


File protection: 
File organization: 
File attributes: 

Record format: 
Record attributes: 


Created: 
Revised: 
Expires: 
Backup: 


18-AUG-1995 14:10 
18-AUG-1995 14:10 
[None specified] 
[No backup done] 


( 2 ) 


System:RWED, Owner:RWED, Group:RE, World 
Sequential 

Allocation = 1, Extend = 0 
Global Buffer Count = 0 
Variable length, maximum 255 bytes 
Carriage return 


[RINGO.STONES]GRANITE.DAT;1 

size: 1/1 Created: 18-AUG-1995 14:11 

Owner: [000200,000200] Revised: 18-AUG-1995 14:11 
File ID: (92,9,1) Expires: [None specified] 

„. n . Backup: [No backup done] 

File protection: System:RWED, Owner:RWED, Group:RE, World- 

File organization: Sequential 
File attributes: Allocation = 1, Extend = 0 

Global Buffer Count = 0 


Record format: Variable length, maximum 255 bytes 

Record attributes: Carriage return 


( 2 ) 


Total of 4 files, 16 blocks 
End of save set 


The command in this example lists the files in save set MTA1:R0CK.BCK in full 
format. 


/GROUP SIZE 

Output Save-Set Qualifier 

Defines the number of blocks BACKUP places in each redundancy group. 

Format 

input-specifier output-save-set-spec/GROUP_SIZE=n 

Description 

BACKUP writes redundant information to output save sets to protect against 
data loss. Using the redundant information, BACKUP can correct one 
uncorrectable read error in each redundancy group. The /GROUP_SIZE qualifier 
specifies the number of output blocks written to each redundancy group The 
value of n can be 0 to 100. The default value is 10. 

If you define a value of 0 for /GROUP_SIZE, no redundancy groups are created 
for the save set. 
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Example 

$ BACKUP/RECORD DBAl/SINCE=BACKUP TAPE:SAVEWORK.BCK/GROUP_SIZE=5 

This BACKUP command saves all files in the current default directory tree that 
have been modified since the last BACKUP/RECORD operation; the /GROUP_ 
SIZE defines the redundancy group size as 5 blocks. 


/IGNORE=option 

Command Qualifier 

Specifies that a BACKUP save or copy operation will override restrictions placed 
on files or will not perform tape label processing checks. 


Format 

/IGNORE=option input-specifier output-specifier 

qualifier has four options: 

Processes files on a tape that is protected by a volume 
accessibility character, or on a tape created by HSC 
Backup. The option applies only to tapes. It affects 
the first tape mounted and all subsequent tapes in 
the save set. 

Processes files that otherwise could not be processed 
due to file access conflicts. Use this option to save 
or copy files currently open for writing. Note that 
no synchronization is made with the process writing 
the file, so the file data that is copied might be 
inconsistent with the input file, depending on the 
circumstances (for example, if another user is editing 
the file, the contents might change). When a file 
open for writing is processed, BACKUP issues the 
following message: 

%BACKUP-W- 

ACCONFLICT, 'filename' is open for write by another user. 

The INTERLOCK option is especially useful if you 
have files that are open so much of the time that they 
might not otherwise be saved. The use of this option 
requires the user privilege SYSPRV, a system UIC, or 
ownership of the volume. 


Description 

The /IGNORE=option 
ACCESSIBILITY 


INTERLOCK 
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LABEL.PROCESSING 


NOBACKUP 


Saves or copies the contents of files to the specified 
magnetic tape volume regardless of the information 
contained in the volume header record. BACKUP 
does not verify the volume label or expiration date 
before writing information to the tape volume. Note 
that you cannot use this option with the /EXACT_ 
ORDER qualifier. 

Saves or copies both the file header record and the 
contents of files marked with the NOBACKUP flag 
by the /NOBACKUP qualifier of the DCL command 
SET FILE. If you do not specify this option, BACKUP 
saves only the file header record of files marked with 
the NOBACKUP flag. 


Examples 

1. $ BACKUP/IGNORE= INTERLOCK 
_From: DUAO:[SUSAN...] 

—To: MTAO:SONGBIRD.BCK/LABEL=TAPE01 

This command saves an entire directory tree and the files in all 
subdirectories, including any files that are open. 

2. $ BACKUP/IGNORE=LABEL_PROCESSING *.*;* MFA1:MYFILES.BCK/REWIND 

This command rewinds the tape in drive MFA1 to the beginning-of-tape 
marker, initializes the tape, and creates a save set containing all files in 
the user’s current directory. The command qualifier /IGNORE=LABEL_ 
PROCESSING specifies that no tape label processing checks are done before 
BACKUP initializes the tape. When the tape is initialized, access to data that 
previously resided on the tape is lost. 

3. $ INITIALIZE/LABEL=VOLUME_ACCESSIBILITY:"K" MUA1: 29JUN 
$ BACKUP/IGN0RE=(ACCESSIBILITY) 

_From: DUAO:[BOOKS...] 

_To: MUA1:BACKUP.SAV /LABEL=29JUN 

The INITIALIZE command in this example initializes the tape with an 
accessibility character (K) and a volume label (29JUN). The BACKUP 
command mounts the tape, regardless of the accessibility, and performs the 
BACKUP operation. For more information on tape protection, refer to the 
OpenVMS System Manager’s Manual. 


/IMAGE 


Command Qualifier 

Directs BACKUP to process an entire volume or volume set. 

Format 

/IMAGE input-specifier output-specifier 
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To use the /IMAGE qualifier, you need write access to the volume index file 
(INDEXF.SYS) and the bit map file (BITMAP.SYS), or the input medium must be 
write-locked. BACKUP opens the index file to synchronize with the file system 
(no update is made). Finally, you must have read access to all files on the input 
medium. 

When you use the /IMAGE qualifier to save a disk, ALIAS directory trees are not 
processed. Only the primary files that the ALIAS points to are saved. Depending 
on the number of ALIAS directory specifications there are on the disk, this 
may increase performance by reducing the number of files BACKUP checks for 
processing. 

_ Note --- 

The input and output devices in an image operation must be different 
except in an image save operation when the output device is a Files—11 
disk save set. 


If the output volume is a disk, all files on the output volume are stored 
contiguously. Contiguous storage of files eliminates disk fragmentation and 
creates contiguous free blocks of disk space. 

Because all files on the input volume are processed, you cannot use input file- 
selection qualifiers in image copy or save operations. You can, however, restore 
files and directories selectively from an image save set. 

When performing image operations on volume sets (more than one volume), the 
number of volumes specified by the output specifier must be equal to the number 
of volumes in the input volume set. 

In an image save or copy operation, BACKUP attempts to save or copy all files 
on the input disk volume including files marked for deletion and lost files (files 
without a directory entry). However, by default a BACKUP image operation 
does not save or copy two types of files. These are files that are flagged as 
NOBACKUP by the DCL command SET FILE/NOBACKUP and files that are 
open for write access by another user at the time of the image save operation. 

If you want these files to be included, specify the command qualifier /IGNORE 
in the BACKUP command line. The command qualifier /IGNORE=NOBACKUP 
directs BACKUP to save or copy files flagged as NOBACKUP. The command 
qualifier /IGNORE=INTERLOCK directs BACKUP to save or copy files open for 
write access by another user. 

An image restore or copy operation initializes the output volume or volume set. 
The initialization data comes from the save-volume summary record of the input 
volume unless the command qualifier /NOINITIALIZE is specified. Specifying 
/NOINITIALIZE directs BACKUP to initialize the output volume using volume 
initialization data that already exists on the output volume. 

In image restore and copy operations, every file is restored or copied. The output 
volume must be mounted using the /FOREIGN qualifier. The new volume is a 
functionally equivalent copy of the input volume; however, file placement will 
change. Files are stored contiguously on the output volume. 









BACKUP 

/IMAGE 


You cannot change the structure level of the output volume in an image restore or 
copy operation. A BACKUP operation to mixed tape and disk save sets, as shown 
in the following command, is unsupported: 


$ BACKUP SYS$DISK:/IMAGE dkaO:FUN,MKAO:/SAVE/REW 


Examples 


$ MOUNT/FOREIGN DMA1: 

%MOUNT-I-MOUNTED, mounted on N0DE$DMA1: 

$ BACKUP/IMAGE/LOG DLA2: DMA1: 

%BACKUP-S-CREATED, created DMA1:[000000]000000.DIR;1 
created DMA1:[000000]BACKUP.SYS;1 
created DMA1:[000000]CONTIN.SYS;1 
created DMA1:[000000]CORIMG.SYS;1 
created DMA1:[000000]ELLA.DIR;1 
created DMA1:[ELLA]SCAT.DAT;1 
created DMA1:[000000]JOE.DIR;1 
created DMA1:[JOE]STRINGS.DAT;1 
created DMA1:[000000]OSCAR.DIR;1 
created DMA1:[OSCAR]KEYS.DAT;1 
created DMA1:[000000]VOLSET.SYS;1 


% BACKUP-S-CREATED, 
%BACKUP-S-CREATED, 
%BACKUP-S-CREATED, 
%BACKUP-S-CREATED, 
% BACKUP-S-CREATED, 
%BACKUP-S-CREATED, 
%BACKUP-S-CREATED, 
%BACKUP-S-CREATED, 
% BACKUP-S-CREATED, 
%BACKUP-S-CREATED, 


$ 

The MOUNT command prepares the target disk for the image copy operation. 
The command qualifier /LOG directs BACKUP to display information about 
each file copied on your terminal. The BACKUP command initializes DMA1 
and copies the disk volume DLA2 to DMA1. All files on DMA1 are stored 
contiguously. 

2. $ BACKUP/IMAGE DBA2: MTA0:ET.BCK,MTA1: 

This command saves an entire disk volume to a multivolume save set named 
ET.BCK using two magnetic tape drives. 

3. $ MOUNT/FOREIGN DBA1: 

%MOUNT-I-MOUNTED, mounted on NODE$DBAl: 

$ BACKUP/IMAGE WORKDISK DBA1:28SEP.BCK/SAVE_SET 

The MOUNT command prepares the target disk for the image save operation. 
The BACKUP command performs an image save operation to a Files-11 save 
set named 28SEP.BCK. 


/INCREMENTAL 


Command Qualifier 

Allows you to restore an incremental save set. 

Format 

/INCREMENTAL save-set-spec disk-device-name 
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Description 

Use /INCREMENTAL only in restore operations that restore incremental save 
sets. When you use /INCREMENTAL, the output specifier must specify a device 
only; file specifications are not allowed. Also, input save-set qualifiers are not 
allowed in incremental restore operations. 

You can create incremental save sets with the command qualifier /RECORD and 
the file-selection qualifier /SINCE=BACKUP or /SINCE=date. Most sites perform 
daily incremental save operations to keep copies of files created or modified that 
day, and periodic full backups to keep a copy of all files on the disk volume. 
(Digital recommends that you use the command qualifier /IMAGE to perform full 
backups.) 

If a disk volume is lost, corrupted, or destroyed, its contents can be recreated by 
performing the following tasks: 

1. Restore the volume using the latest (most recent) image backup save set. 

(The saveset must have been created using the /IMAGE and /RECORD 
BACKUP command qualifiers.) 

2. Restore any incremental save sets since the last full backup, in reverse 
chronological order, using the /INCREMENTAL qualifier. 

After you restore the save sets in this order, the output disk volume contains 
the same files it contained when the most recent incremental save operation was 
performed. 

When the /INCREMENTAL qualifier is used, the /BY_OWNER=ORIGINAL 
qualifier is assumed; therefore, specifying /BY_OWNER is unnecessary unless you 
want to change the original UICs. The /INCREMENTAL qualifier can be used 
only on Files-11 Structure Level 2 volumes. 


Example 

If you have been performing a combination of full backups and incremental 
save operations on a public volume, and the public volume is lost, corrupted, or 
destroyed, use a procedure like the following to create a new copy of the public 
volume. First, restore the volume from the latest full backup with an image 
restore operation. Note that the /RECORD qualifier is necessary to perform the 
operation correctly. 

$ MOUNT/FOREIGN DRAO: 

%MOUNT-I-MOUNTED, mounted on _DRA0: 

$ BACKUP/IMAGE/RECORD MTAO:FULLJUN95,MTAl DRAO: 

%BACKUP-I-RESUME, resuming operation on volume 2 
%BACKUP-I-RESUME, resuming operation on volume 3 
%BACKUP-I-RESUME, resuming operation on volume 4 


$ DISMOUNT/NOUNLOAD DRAO: 

Next, mount the disk as a file-structured volume and restore the incremental save 
sets in reverse chronological order. Finally, restore the weekly incremental save 
sets. The /INCREMENTAL qualifier must be used where shown in the following 
example to obtain the correct results: 
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$ MOUNT DRAO: PUBLIC 

%MOUNT-I-MOUNTED, PUBLIC mounted on _DRA0: 

$ BACKUP/INCREMENTAL MTAO:INCD17JUN DRAO: 

$ BACKUP/INCREMENTAL MTAO:INCD16JUN DRAO: 

$ BACKUP/INCREMENTAL MTAO:INCD15JUN DRAO: 

$ BACKUP/INCREMENTAL MTAO:INCW14JUN DRAO: 

$ BACKUP/INCREMENTAL MTAO:INCW7JUN DRAO: 

Note that BACKUP restores the volume correctly regardless of the order in which 
the incremental save sets are applied; using reverse chronological order is most 
efficient. 


/INITIALIZE 


Command Qualifier 

Initializes an output disk volume, making its entire previous contents 
unavailable. 

Format 

/[NOJINITIALIZE input-specifier output-specifier 

Description 

The /[NOJINITIALIZE qualifier is valid only when used with the command 
qualifier /IMAGE during restore or copy operations or when saving files to a 
sequential-disk save set. 

When used with the command qualifier /IMAGE in a restore or copy operation 
the /INITIALIZE qualifier directs BACKUP to initialize the output volume using 
volume initialization data from the save-volume summary record on the input 
volume. 

The /NOINITIALIZE qualifier directs BACKUP to reinitialize the output volume 
using the existing initialization data on that volume; the output volume must 
have been previously initialized as a Files-11 volume. When the output volume is 
initialized, existing data on the volume is lost. The structure level of the output 
volume must be the same as the structure level of the save set being restored. 

Z^r re 3nd C ° Py ° perations on Files-11 volumes, the default is 

If you use the /INITIALIZE qualifier when creating sequential-disk save sets, 
BACKUP initializes the first output volume in the sequential-disk save set as 
well as subsequent volumes. By default, BACKUP does not initialize the first 
volume of a sequential-disk save set but does initialize subsequent volumes of a 
multivolume sequential-disk save set. 

Examples 

1. $ BACKUP/IMAGE/NOINITIALIZE DBAO: DBA2: 

This command causes the output volume DBA2 to be reinitialized using the 
volume initialization data that exists on DBA2. The contents of DBAO are 
then copied to DBA2. 
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2. $ BACKUP/ IMAGE/INITIALIZE DBA2:OLDFILES.BCK/SAVE_SET DBA6: 

This command directs BACKUP to initialize the output volume DBA6 using 
volume initialization parameters in the save-volume summary record on 
DBA2. The image save set OLDFILES.BCK is then restored to DBA6. 


/INTERCHANGE 

Command Qualifier 

Directs BACKUP to process files in a manner suitable for data interchange 
(software distribution) by excluding information that would prevent other utilities 
or sites from reading the BACKUP save set. 


Format 

/INTERCHANGE input-specifier output-specifier 

Description 

The effects of the /INTERCHANGE qualifier are as follows: 

• Directories not selected as files are not copied. 

• Access control lists are not copied. 

• Block size on magnetic tape is limited to 8192 bytes. 

• Normal error recovery is used to write magnetic tapes so that no bad records 
exist on the resulting magnetic tape. 

Example 

$ BACKUP/RECORD/INTERCHANGE [ACCOUNTS]/SINCE=BACKUP MFAO:SAVACC.BCK 

The command in this example saves all files in the directory [ACCOUNTS] 
that have been modified since the last BACKUP/RECORD operation. The 
/INTERCHANGE qualifier ensures that the processed files are suitable for data 
interchange. 


/JOURNAL 

Command Qualifier 

Specifies that a BACKUP save operation is to create a BACKUP journal file or 
append information to a BACKUP journal file. Lists the contents of a BACKUP 
journal file when combined with the command qualifier /LIST. 

Format 

/JOURNAL[=file-spec] input-specifier output-specifier 
/JOURNAL[=file-spec]/LIST[=file-spec] 
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Description 

A BACKUP journal file contains records of BACKUP save operations and the file 
specifications of saved files. Use the command qualifier /JOURNAL[=file-spec] in 
a BACKUP save operation to create a journal file. 

If you do not include a file specification with the command qualifier /JOURNAL, 
the name of the BACKUP journal file defaults to SYS$DISK:[ JBACKUP.BJL. You 
can specify another file name, however. (The file specification of a journal file 
cannot include a node name; the default file type for a journal file is .BJL.) If the 
specified journal file does not exist, it is created; if the journal file does exist, the 
new journal information is appended to the existing journal file. 

Start a new version of a journal file by creating a zero-length file using the DCL 
command CREATE or a text editor. 

To list the contents of a BACKUP journal file, use the /JOURNAL=[file-spec] 
qualifier with the /LIST qualifier, but do not specify an input or output specifier. 
By default, the list is displayed on SYS$OUTPUT, but it is written to an output 
file if you specify a file with /LIST. 

When listing a journal file, you can use the file-selection qualifiers /BEFORE, 
/SINCE, and /EXCLUDE to search for specific files. (In this context, the 
/BEFORE and /SINCE qualifiers refer to the time when the save set was created, 
not the time when the files in the save set were created.) Also, by specifying a file 
in a multivolume save set, you can search the journal file to find which volume 
the file is in. You can then mount that volume and restore the file. 

Journal files are not created for physical save operations (save operations 
performed with the command qualifier /PHYSICAL). 


Examples 

1. $ BACKUP/JOURNAL=LAR.BJL [LARRY]*.*;* MFAO:YET.BCK 

This command saves all versions of all files in the directory [LARRY] to the 
save set YET.BCK on MFAO. The /JOURNAL qualifier creates a record of the 
saved files in a journal file named LAR.BJL in the current default directory. 

2. $ BACKUP/LIST/JOURNAL=ARCH.BJL/SELECT=[SMITH.PROGS]/SINCE=5-OCT-1994 
Listing of BACKUP journal 

Journal file _DB1:[SYSMGR]:ARCH.BJL;1 ON 7-OCT-1994 00:45:43.01 
Save set WKLY.BCK, created on 6-OCT-1994 00:01:34.54 
Volume number 1, volume label WKL101 

[SMITH.PROGS]REMINDER.FOR;4 6 
[ SMITH. PROGS ] RUNTHIS. FOR; 4 
[ SMITH.PROGS]TIMER.PAS;5 


This example displays all files in the directory [SMITH.PROGS] that 
were saved after October 5, 1994, and listed in the BACKUP iournal file 
ARCH.BJL. 
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3. $ BACKUP/JOURNAL/LOG/IMAGE DRA2: MTAO:30CT.FUL 

%BACKUP-S-COPIED, copied DRA2:[COLLINS]ALPHA.DAT;4 
%BACKUP-S-COPIED, copied DRA2:[COLLINS]EDTINI.EDT;5 


%BACKUP-I-RESUME, resuming operation on volume 2 
%BACKUP-I-READYWRITE, mount volume 2 on _MTA0: for writing 
Press return when ready: I Return | 

%BACKUP-S-COPIED, copied DRA2:[LANE]MAIL.MAI;1 
%BACKUP-S-COPIED, copied DRA2:[LANE]MEMO.RNO;5 


$ BACKUP/JOURNAL/LIST 
Listing of BACKUP journal 

Journal file _DB2:[SYSMGR]BACKUP.BJL;1 on 3-OCT-1994 00:40:56.36 
Save set 30CT.FUL created on 3-OCT-1994 00:40:56.36 
Volume number 1, volume label 3OCT01 

[COLLINS]ALPHA.DAT;4 
[COLLINS]EDTINI.EDT;5 
[COLLINS]LOGIN.COM;46 
[COLLINS]LOGIN.COM;4 5 
[COLLINS]MAIL.MAI;1 
[COLLINS.MAR]GETJPI.EXE;9 
[COLLINS.MAR]GETJPI.LIS;14 


[LANE]LES.MAI;1 


Save set 30CT.FUL created on 3-OCT-1994 00:40:56.36 
Volume number 2, volume label 3OCT02 

[LANE]MAIL.MAI;1 
[LANE]MEMO.RNO;5 
[LANE]MEMO.RNO;4 


[WALTERS.VI]KD.RNO;52 
End of BACKUP journal 

This example shows how to create a BACKUP journal file and list the 
contents of the BACKUP journal file. 


/LABEL 


Output Save-Set Qualifier 

Specifies the volume labels for the magnetic tapes to which the save set is written. 

Format 

input-specifier output-save-set-spec/LABEL=(string[,...]) 
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Description 

Use the label qualifier to specify the one- to six-character volume labels for the 
magnetic tapes to which the save set is written. 

You can specify either a single label or a list of labels with the /LABEL qualifier. 
If you do not specify the /LABEL qualifier, BACKUP uses the first six characters 
of the save-set name as the volume label of the first tape. If you specify a label 
that is longer than six characters, BACKUP truncates the label to six characters. 

If the save set continues to another tape, and you did not specify a volume label 
for the tape, BACKUP uses the first four characters of the previous tape’s volume 
label followed by the volume number of the tape. For example, if the first tape in 
a save set is labeled AAAABB, the second tape in a save set is labeled AAAA02, 
and the third tape is labeled AAAA03. 

Before writing a save set to magnetic tape, BACKUP compares the label specified 
in the command line to the volume label of the tape. (If the tape has no volume 
label and you specified the output save-set qualifier /REWIND, BACKUP writes 
the label you specified to the volume header record of the tape.) If the volume 
label has fewer than six characters, BACKUP pads the volume label with the 
blank character to six characters. 

The first four characters of the volume label must either exactly match the 
first four characters of the label specified in the BACKUP command line, or the 
first four characters of the volume label must end with one or more underscore 
characters. If the first four characters of the volume label end with one or more 
underscore characters, and the label specified in the command line matches 
the part of the volume label that appears before the underscore characters, 
BACKUP accepts the match. (For example, the volume label ABN_ matches the 
command line label ABN but does not match the command line label ABNE.) If 
either the fifth or the sixth character of the volume label is in the range 0 to 9, 
BACKUP does not compare these characters with corresponding characters in 
the label specified in the BACKUP command line. Otherwise, the fifth and sixth 
characters in the volume label must match the corresponding characters in the 
label specified in the BACKUP command line exactly. 

The following table illustrates volume labels that match labels specified in the 
BACKUP command line: 


Label Specified in the 
Command Line 

Matching Volume Labels 

MAR 

MAR, MAR_, MAR_nn 

MAR_ 

MAR_, MAR_nn 

MARK 

MARK, MARKnn 

MARKER 

MARKER, MARKnn 


If the label you specify matches the tape’s volume label, the BACKUP save 
operation proceeds. If you specify more than one label with the /LABEL qualifier, 
the BACKUP save operation succeeds if any of the labels you specify match the 
tape’s volume label. For example, if the tape’s volume label is MA1686, the save 
operation will succeed if you specify the following list of labels with the /LABEL 
qualifier: 

/LABEL=(MA1684,MA1685,MA1686) 
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If the label you specified does not match the tape’s volume label, BACKUP 
displays the following messages and prompt on your terminal if you specified the 
command qualifier /NOASSIST, or on the operator terminal if you did not specify 
/NOASSIST: 

%BACKUP-W-MOUNTERR, volume 'number' on 'device' was not mounted because 
its label does not match the one requested 
Specify option (QUIT, NEW tape or OVERWRITE tape) 

BACKUP> 

Specify QUIT to abort the BACKUP operation and unload the magnetic tape. 
Specify NEW to direct BACKUP to prompt for a new tape. Specify OVERWRITE 
to direct BACKUP to ignore the label mismatch, mount the tape, initialize the 
tape if you specified the output save-set qualifier /REWIND, and write the save 
set to the tape. 

You can specify the command qualifier /IGNORE=LABEL_PROCESSING to 
prevent BACKUP from verifying the volume label of the tape. You can also use 
the /EXACT_ORDER qualifier to specify the exact order of tape volume labels 
that you want to use in a BACKUP operation. 

Examples 

1. $ BACKUP [PAYROLL] MTAO:3ONOV.BCK/LABEL=PAY 

This command causes BACKUP to check the volume label of the tape 
mounted on drive MTAO. If the volume label is PAY, BACKUP saves the 
directory [PAYROLL] to a save set named 30NOV.BCK. 

2. $ BACKUP DDA1: MTAO:PLAYS.BCK,MTA1,MTA2/REWIND/LABEL=(ACT1,ACT2,ACT3) 

This example assumes that the three tapes have no volume labels. This 
command saves all files on the disk named DDA1 to the save set PLAYS.BCK. 
The first tape in the save set is labeled ACT1, the second is labeled ACT2, 
and the third is labeled ACT3. 


/ LIST 


Command Qualifier 

Lists information about a BACKUP save set and about the files in a save set. You 
can display the list on your terminal or write it to a file. 


Format 

/LIST[=file-spec] save-set-spec 

Description 

Use the /LIST qualifier by itself or in conjunction with any other operation (save, 
restore, copy, compare, or journal). If /LIST is specified by itself (not with a save, 
restore, copy, compare or journal operation), the input specifier must refer to a 
save set, and the output specifier must be omitted. 

Before you can list the contents of a save set, the media containing the save set 
must be inserted into an appropriate drive. If the save set is stored on a disk, 
the disk must be mounted as a Files-11 volume or as a foreign volume. BACKUP 
mounts magnetic tapes automatically as part of the list operation. 
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Example 


/LOG 


Format 


By default, the list information is displayed on your terminal; however, you can 
specify a file to which the list information can be written. 


When you use the /LIST qualifier with standalone BACKUP and you direct output 

to a file (/LIST=file-spec), the file specification must refer to either a terminal or a 
printer. 


You can use either the command qualifier /BRIEF or /FULL with the /LIST 
qualifier. The /BRIEF qualifier directs BACKUP to list each file’s size in blocks 
and its creation date. The /FULL qualifier directs BACKUP to list additional 
information about each file in the same format as the information provided by the 
DCL command DIRECTORY/FULL. The default is /BRIEF. 


Do not use the command qualifier /LOG with /LIST when the output for /LIST is 
directed to the terminal; if you do, you will receive confusing output. 


$ BACKUP/LIST DBA2:[SAVE]23MAR95.BCK/SAVE_SET 
Listing of save set(s) 


Save set: 
Written by: 
UIC: 

Date: 
Command: 


23MAR95.BCK 

MOROCI 

[ 000200 , 000200 ] 

23-MAR-1995 14:18:16.96 

BACKUP [SAVE] DBA2:[SAVE]23MAR95.BCK/SAVE_SET 


Operating system: VAX/VMS version 6.2 


BACKUP version: V6.2 

CPU ID register: 08000000 

Node name: _SUZI:: 

Written on: _DBA2: 

Block size: 32,256 

Group size: 10 

Buffer count: 3 


[SAVE]LAST.DAT;1 
[SAVE]INFO.TXT;4 
[SAVE]WORK.DAT;3 

Total of 3 files, 39 
End of save set 


1 

5 

33 

blocks 


18-JAN-1995 14:11 
4-FEB-1995 13:12 
l-JAN-1995 10:02 


This command lists the BACKUP summary information and the file name, size, 
and creation date for each file in the save set. Note that the /SAVE_SET qualifier 
is required to identify the input specifier as a save set on a Files-11 disk. 


Command Qualifier 

Determines whether the file specification of each file processed is displayed on 
SYS$OUTPUT during the operation. The default is /NOLOG. 


/[NO]LOG input-specifier output-specifier 
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Example 

$ BACKUP/LOG [SAVE]23MAR95.BCK/SAVE_SET DBA2:[PLI.WORK] 

%BACKUP-S-CREATED, created DBA2:[PLI.WORK]ANOTHER.DAT;1 
%BACKUP-S-CREATED, created DBA2:[PLI.WORK]LAST.DAT;1 
%BACKUP-S-CREATED, created DBA2:[PLI.WORK]THAT.DAT;1 
%BACKUP-S-CREATED, created DBA2:[PLI.WORK]THIS.DAT;2 


In this example, the file specifications of the files restored to the directory named 
[PLI.WORK] on DBA2 are logged to SYS$OUTPUT. 


/MEDIA_FORMAT=[NO]COMPACTION 


Format 

Output Save-Set Qualifier 

Controls whether data records are automatically compacted and blocked together. 
Data compaction and record blocking increase the amount of data that can be 
stored on a single tape cartridge. 

The compaction ratio depends on the data and the tape drive you use. For more 
information, see the documentation supplied with your tape drive. 

input-specifier output-save-set-spec /MEDIA_FORMAT=[NO]COMPACTION 


Description 

The /MEDIA.FORMAT qualifier can only be used with tape drives that support 



data compaction. 

Once data compaction has been selected for a tape cartridge, compaction is 
used for the entire cartridge until you initialize the cartridge with the /MEDIA_ 
FORMAT=NOCOMPACTION qualifier. 

You can use the /MEDIA_FORMAT=COMPACTION qualifier for hardware data 
compaction of SCSI tape drives. ♦ 

Example 

$ BACKUP WORK$:[TESTFILES...]*.*;* MUAO:TEST.SAV - 
_$/MEDIA_FORMAT=COMPACTION /REWIND 

This command saves all files in the directory [TESTFILES] and its subdirectories 
in a save set named TEST.SAV using a TA90E tape drive. The /MEDIA_ 
FORMAT=COMPACTION qualifier specifies that the tape drive automatically 
compacts and blocks together data records on the tape. 
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/MODIFIED 

Input File-Selection Qualifier 

Selects files according to the value of the modified date field (the date the file was 
last modified) in each file header record. 

Format 

input-specifier/BEFORE=time /MODIFIED output-specifier 
input-specifier /SINCE=time /MODIFIED output-specifier 

Description 

You must use the /MODIFIED qualifier with either of the input file-selection 
qualifiers /BEFORE or /SINCE. The date and time you specify with /BEFORE or 
/SINCE determines which files are processed. 

You cannot use /MODIFIED with the input file-selection qualifiers /BACKUP 
/CREATED, or /EXPIRED. 

Example 

$ BACKUP [SUNDANCE...]/BEFORE=TODAY/MODIFIED MFA1:MOD.BCK 

This command saves all files in the directory tree [SUNDANCE] whose 
modification dates precede today (00:00:00.0 o’clock of the current day, month, 
and year). 


/NEW_VERSION 

Output File Qualifier 

Creates a new version of a file if a file with an identical specification already 
exists at the location to which the file is being restored or copied. 

Format 

input-specifier output-specifier/NEW_VERSION 


Description 

If BACKUP attempts to copy or restore a file when a file with an identical 
directory name, file name, type, and equal or higher version number already 
exists, a new file is created with the same name and type and a version number 
one higher than the highest existing version. 

If you do not use /NEW_VERSION, /REPLACE, or /OVERLAY, and the version 
number of the file being restored is equal to or less than the version number of 
the existing file, BACKUP reports an error in copying or restoring the file. 

Note that when copying or restoring files using the /NEW_VERSION qualifier, 
files are processed in decreasing version number order and are created in 
ascending order. The result is that the version numbers are inverted. 
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Because this qualifier causes version numbers to change, using it with the 
/VERIFY qualifier will cause unpredictable results. Digital recommends that you 
do not use the /NEW.VERSION qualifier with the /VERIFY qualifier. 

Example 

$ BACKUP MTA1:N0V3OREC.BCK/SELECT=*.DAT [RECORDS...]/NEW_VERSION 

This example restores all files with the file type of .DAT from the magnetic tape 
save set NOV30REC.BCK to the directory [RECORDS], The /NEW_VERSION 
qualifier instructs BACKUP to restore each file with the file type .DAT regardless 
of whether a file with the same file specification already exists. 


/OVERLAY 

Output File Qualifier 

Writes the input file over a file with an identical specification at the output 
location. 


Format 

input-specifier output-specifier/OVERLAY 

Description 

If BACKUP attempts to copy or restore a file when a file with an identical 
directory name, file name, type, and version number already exists, the new 
version of the file is written over the existing version. The file identification of 
the new version is the same as the file identification of the file that is overwritten. 

The physical location of the file on disk does not change. If /OVERLAY is 
specified, and the new file is larger than the one already present, BACKUP 
allocates more blocks on the disk and extends the file. 

When you do not use /OVERLAY, /REPLACE, or /NEW_VERSION, and the 
version number of the file being restored is identical to the version number of the 
existing file, BACKUP reports an error in copying or restoring the file. 

Example 

$ BACKUP DRAl:MAR3OSAV.BCK/SAVE_SET [RECORDS...]/OVERLAY 

The sequential-disk save set MAR30SAV.BCK is restored to the directory tree 
[RECORDS...]. If a file from the save set has a specification that is identical 
to a file that already exists in [RECORDS...], the /OVERLAY qualifier directs 
BACKUP to write over the existing version. 
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/OWNEFLUIC 


The /OWNER_UIC qualifier has been superseded by /BY_OWNER. Digital 
recommends that you substitute /BY_OWNER for /OWNER_UIC in command 
procedures and operator instructions. See the description of /BY_OWNER for 
more information. 


/PHYSICAL 


Command Qualifier 

Specifies that a BACKUP operation is to ignore any file structure on the input 
volume and to process the volume in terms of logical blocks. 

Format 

/PHYSICAL input-specifier output-specifier 

Description 

In a physical operation, BACKUP saves, restores, copies, or compares the entire 
volume in terms of logical blocks. 

The input and output specifiers for physical volumes must be device names, 
and they cannot be the same device. Also, the following qualifiers are ignored if 
specified with the /PHYSICAL qualifier: /DELETE, /IMAGE, /INCREMENTAL, 
/JOURNAL, and /RECORD. 

For physical copy operations between disks, the output disk must be the same 
type of device as the input disk; for example, a BACKUP/PHYSICAL operation 
cannot be performed between an RP05 input disk and an RP06 output disk. The 
output disk must not have a bad block in any location that corresponds to a good 
block on the input disk. (This restriction does not apply to RA series disks.) 

For physical save operations between disks, the output disk must be the same 
type of disk as the input disk or a larger capacity disk. The output disk must not 
have a bad block in any location that corresponds to a good block on the input 
disk. (This restriction does not apply to RA series disks.) 

For physical restore operations between disks, the output disk must be the same 
type of device as the disk from which the save set was created. The output disk 
must not have a bad block in any location that corresponds to a good block on the 
disk from which the save set was created. (This restriction does not apply to RA 
series disks.) 

An output disk of a physical operation must be mounted using the DCL command 
MOUNT/FOREIGN. An input disk of a physical operation must either be 
mounted using the DCL command MOUNT/FOREIGN, or the user must have the 
user privilege LOG_IO or PHY_IO. 

You can perform physical save and restore operations using magnetic tapes. 
BACKUP mounts magnetic tapes automatically as foreign devices. 
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A save set written using the /PHYSICAL qualifier can only be read as a physical 
save set; conversely, a file-structured save set can only be read with file-structured 
restore or compare operations. 


_Note - 

BACKUP/PHYSICAL does not copy the first track (track 0) of RX01 and 
RX02 diskettes; Digital does not support track 0. 


Examples 


1. $ MOUNT/FOREIGN DYAO: 

$ MOUNT/FOREIGN DYA1: 

$ BACKUP/PHYSICAL DYAO: DYA1: 

This example mounts RX02 diskettes in DYAO and DYA1 as foreign devices 
and copies the contents of the diskette mounted in DYAO to the diskette 
mounted in DYA1. 

2. $ MOUNT/FOREIGN DBA1: 

$ BACKUP/PHYSICAL MTA0:28SEP.BCK DBA1: 

This command restores a physical save set named 28SEP.BCK to DBA1. 


/PROTECTION 

Output Save-Set Qualifier 

When you create a save set on disk, this qualifier defines the protection to be 
applied to an output save set. When you create a save set on magnetic tape, this 
qualifier defines the protection to be applied to the magnetic tape volume. (All 
save sets created subsequently on the tape will receive this same protection until 
the tape is initialized.) 


Format 

input-specifier output-save-set-spec/PROTECTION[=(code)] 


Description 

Because the file system treats a BACKUP save set as a single file, it is crucial 
that you protect save sets adequately. If you do not specify adequate protection, 
anyone who has access to a save set can access any file in the save set. 

The protection code indicates the type of access (read, write, execute, and delete) 
available to the four categories of users (system, owner, group, and world). 

For more information on specifying protection codes, see the OpenVMS User’s 
Manual. 

If the save set is written to either a Files—11 disk or a sequential disk and 
/PROTECTION is not specified, BACKUP applies the process default protection to 
the save set. If /PROTECTION is specified, any protection categories not specified 
default to your default process protection. 
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Protection information is written to the volume header record of a magnetic tape, 
and applies to all save sets stored on the tape. If you specify /PROTECTION, 
any protection categories that you do not specify default to your default process 
protection. 

To initialize a magnetic tape with the correct protection, specify the output save- 
set qualifier /REWIND with the /PROTECTION qualifier. If you do not specify 
/REWIND with /PROTECTION, the protection information, if any, in the volume 
header record is not changed. However, specifying /PROTECTION without 
/REWIND ensures that continuation volumes receive the correct protection. 

If the save set is written to magnetic tape and /PROTECTION is not specified, 
BACKUP applies no protection to the tape. 

In order to initialize a magnetic tape volume that was previously initialized with 
the /PROTECTION qualifier, you must own the volume (your UIC matches the 
UIC of the volume) or have the VOLPRO privilege. 

Example 

$ BACKUP 

.From: [CLEAVER...] 

—To: MFA2:ACCOUNTS.BCK/BY_OWNER=[301,310]/REWIND/LABEL=BANK01- 
_$ /PROTECTION(S:RWE,0:RWED,G:RE,W) 

This command saves the directory tree [CLEAVER...] to a save set named 
ACCOUNTS.BCK on the magnetic tape labeled BANK01. The output save-set 
qualifier /REWIND directs BACKUP to rewind the tape and initialize it before 
performing the save operation. The output save-set qualifier /BY_OWNER 
assigns an owner UIC of [301,310] to the magnetic tape. The /PROTECTION 
qualifier assigns the owner of the magnetic tape read, write, execute, and delete 
access. SYSTEM users are assigned read, write, and execute access; GROUP 
users are assigned read and execute access; and WORLD users are assigned no 
access. 

$ BACKUP/IMAGE 
_From: DUAO: 

_To: MFA2:DAILY.BCK/REWIND/LABEL=TAPE1- 
_$ /PROTECTION (S: RWED, 0: RWED, G, W) 

$ BACKUP/IMAGE DUA2: MFA2 : DAILY2 . BCK/PROTECTION (S:RWED, 0:RWED, G, W) 

%BACKUP-I-RESUME, resuming operation on volume 2 
%BACKUP-I-READYWRITE, mount volume 2 on _MFA2: for writing 
Press return when ready: |Return| 

This first BACKUP command creates an image backup of the disk DUAO in a 
save set named DAILY.BCK on the magnetic tape labeled BANK01. The output 
save-set qualifier /REWIND directs BACKUP to rewind the tape and initialize it 
before performing the save operation. The /PROTECTION qualifier assigns the 
owner of the magnetic tape and SYSTEM users read, write, execute, and delete 
access; GROUP and WORLD users are assigned no access. 

The second BACKUP command uses the same tape for an image backup of the 
disk DUA2. When the tape is full, BACKUP requests another volume. Because 
the /PROTECTION qualifier was specified with second BACKUP command, the 
continuation volume receives the desired protection. 
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/RECORD 

Command Qualifier 

Records the current date and time in the BACKUP date field of each file header 
record once a file is successfully saved or copied. 

Format 

/RECORD input-specifier output-specifier 

Description 

The /RECORD qualifier can be used only in save or copy operations on Files-11 
Structure Level 2 volumes. To use the /RECORD qualifier on files, the user 
privilege SYSPRV is required. 

When you use /RECORD in a copy or save operation, BACKUP writes the date 
and time that the copy or save set was created in the BACKUP date field of each 
file header record. 

When you use /RECORD to perform incremental save operations on a disk 
volume, do not allow other users to use /RECORD in their BACKUP operations 
on the same disk volume. If other users specify /RECORD, the dates in the 
BACKUP date fields of file header records will change. This makes it impossible 
for you to save all files created or modified since you last performed a save 
operation. 

If you use the command qualifier /VERIFY with /RECORD, files that fail 
verification are not recorded. 

If /RECORD is not specified, the BACKUP date field of each processed file is not 
changed. 

You cannot use the /RECORD qualifier with the command qualifier /DELETE or 
/COMPARE. 

Example 

$ BACKUP/RECORD DBA1:[000000...]/SINCE=BACKUP MTA0:13MAY.BCK 

This command saves all files on DBA1 that have been created or modified since 
the last save operation and records the current date and time in each file header 
record. 


/RELEASE_TAPE 

Command Qualifier 

Dismounts and unloads a tape after a BACKUP save operation writes a save set 
to the tape (and optionally verifies the saveset information on that tape). 
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Format 

/RELEASE.TAPE input-specifier output-specifier 

Description 

By using the /RELEASE.TAPE qualifier in conjunction with either the /DELETE 
or /RECORD qualifiers, you can make a tape drive available for other operations 
before the BACKUP command completes. You can also use the /RELEASE. 
TAPE qualifier without the /DELETE or /RECORD qualifiers, in which case the 
/RELEASE.TAPE qualifier dismounts and unloads the tape in the drive after the 
BACKUP command completes. 

You cannot use the /RECORD and /DELETE qualifiers in the same BACKUP 
command. 

Examples 

1. $ BACKUP/IMAGE/RECORD/RELEASE.TAPE DUA1: MUAO:BACK.BCK 

The command in this example backs up the disk DUA1 to the save set 
BACK.BCK. By using the /RELEASE.TAPE and /RECORD qualifiers, 
BACKUP dismounts and unloads the tape in MUAO (making it available for 
other operations) before it performs the action of the /RECORD qualifier. 

2. $ ALLOCATE MUAO: TAPE 

$ BACKUP/DELETE/RELEASE.TAPE/LOG DUA1:[MAIN...] MUAO:MAIN.BCK 


$ DEALLOCATE TAPE 

The commands in this example back up some directories on a disk named 
DUA1, and then delete the files that have been backed up. The /RELEASE. 
TAPE qualifier dismounts and unloads the tape (making it available for 
other operations) before the /DELETE qualifier performs its action. The tape 
remains allocated until you enter the DEALLOCATE command. 


/REPLACE 

Output File Qualifier 

Replaces a file on the output specifier with an identically named file from the 
input specifier. 

Format 

input-specifier output-specifier/REPLACE 

Description 

When you use /REPLACE in a copy or restore operation, and an identically 
named file exists in both the input and output specifiers, BACKUP does the 
following: 

• Copies or restores a new version of the file with the same directory 
specification, file name, type, and version number 
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• Deletes the copy of the file that previously existed on the output disk 

In this way, the previous copy of the file is replaced with the restored version. 
Note that the version number is not incremented because the old copy of the file 
is deleted. If you want to keep the versions from both the input and the output 
specifiers, use the output file qualifier /NEW_VERSION. 

If you do not use /REPLACE, /OVERLAY, or /NEW_VERSION, and the version 
number of the file being restored is identical to the version number of the existing 
file, BACKUP reports an error and does not restore the file. 

Example 

$ BACKUP MUAO:SAVEWORK.BCK/SELECT=[LEE...] DUAO:[LEE...]/REPLACE 

The command in this example restores the directory tree [LEE...] (and all files 
in the directory tree) from a magnetic tape save set to disk. The input save- 
set qualifier /SELECT specifies the directory tree to be selected from the save 
set. The output file qualifier /REPLACE instructs BACKUP to first create a 
new version of an input file if the output medium has a file with the same file 
specification, and then to delete the file that originally existed on the output 
medium. 


/REWIND 

Input Save-Set Qualifier 

Rewinds the input tape reel to the beginning-of-tape marker before reading the 
input volume. 

Format 

input-save-set-spec/[NO]REWIND output-specifier 

Description 

The /[NO]REWIND qualifier is for magnetic tape volumes only. 

The /REWIND qualifier directs BACKUP to rewind the input magnetic tape to 
the beginning-of-tape marker before reading the input volume. Then BACKUP 
locates the input save set. In this way, BACKUP can find the input save set if it 
is located before the current tape position. 

The /NOREWIND qualifier indicates that BACKUP should not rewind the input 
volume before processing the command. Instead, BACKUP proceeds toward the 
logical end-of-tape (the end of the last save set stored on the tape). Therefore, if 
the specified save set is located before the current position of the tape, BACKUP 
is unable to find it. 

The default is /NOREWIND. You must specify /REWIND to rewind the tape. 
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Example 


$ BACKUP MFA1:CONTRACTS.BCK/REWIND DBA2/BY_OWNER=ORIGINAL 

In this example, the save set CONTRACTS.BCK is restored to the disk volume 
mounted on DBA2. The /REWIND qualifier rewinds the magnetic tape to 
^^? nmg '° f ' tape marker before reading the input volume to search for 
CONTRACTS.BCK. The output file qualifier /BY_OWNER restores the original 
owner UICs. 


/REWIND (output save-set qualifier) 


Output Save-Set Qualifier 

Rewinds the output tape to the beginning-of-tape marker and initializes the 
output tape. The /NOREWIND qualifier causes the tape to wind forward to the 
logical end-of-tape (the end of the last save set stored on the tape) and to begin 
writing the save set there. 

Format 


input-specifier output-save-set-spec/[NO]REWIND 

Description 

The /[NOIREWIND qualifier is for magnetic tape volumes only. 

If you specify /REWIND, BACKUP rewinds to the beginning of the magnetic 
tape and searches the volume header record for a volume label. If the volume 
header record contains no volume label, BACKUP writes the label specified in the 
BACKUP command to the volume header record, initializes the tape, and creates 
the save set on the tape. 

If no label is specified explicitly in the command line, BACKUP uses the first 
six characters of the save-set name as the volume label of the first tape in a 
multivolume save set and the first four characters of the save-set name followed 
by the volume number of the tape as the volume label of subsequent tapes. You 
can also specify a label or list of labels explicitly with the /LABEL qualifier. If 
you do not specify enough labels with the /LABEL qualifier, BACKUP uses the 
first four characters of the final label in the list followed by the volume number of 
the tape as the volume label of subsequent tapes. 

If BACKUP finds a volume label on the tape, it compares the volume label with 
the label you specified in the BACKUP command line (either explicitly with the 
/LABEL qualifier or implicitly through the save-set name) and ensures that the 
tape is expired. 

If the volume label is fewer than six characters long, BACKUP pads the volume 
label with the blank character to six characters. The first four characters 
of the volume label must either match the first four characters of the label 
specified in the BACKUP command line exactly, or the first four characters of 
the volume label must end with one or more underscore characters. If the first 
four characters of the volume label end with one or more underscore characters, 
and the label specified in the command line matches the part of the volume label 
that appears before the underscore characters, BACKUP accepts the match. (For 
example, the volume label ABN_ matches the command line label ABN but does 
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not match the command line label ABNE.) If either the fifth or sixth character 
of the volume label is in the range 0 to 9, BACKUP does not compare these 
characters with corresponding characters in the label specified in the BACKUP 
command line. Otherwise, the fifth and sixth characters in the volume label 
must match the corresponding characters in the label specified in the BAC 
command line exactly. The following table illustrates volume labels that match 
labels specified in the BACKUP command line: 


Label Specified in the 
Command Line 

Matching Volume Labels 

MAR 

MAR, MAR_, MAR_nn 

MAR_ 

MAR_, MAR_nn 

MARK 

MARK, MARKnn 

MARKER 

MARKER, MARKnn 


You can specify more than one label with the /LABEL qualifier. If any label 
specified in the BACKUP command line matches the volume label of the tape and 
the tape is expired, BACKUP overwrites the volume label of the tape with the 
same volume label. 

By overwriting the tape’s volume label, BACKUP initializes the tape, removing 
access to any data that previously resided on the tape and preparing the tape 
to receive new data. During the initialization process, BACKUP writes the 
values specified with the output save-set qualifiers /TAPE_EXPIRATION, 
/PROTECTION, and /BY_OWNER to the volume header record. (If these 
qualifiers are not specified, the default tape expiration date is today, the default 
protection is none, and the owner UIC of the tape is the UIC of the current 
process.) After initializing the tape, BACKUP writes the save set to the tape. 

If the label in the BACKUP command line did not match the volume label of the 
tape, BACKUP displays the following message and prompt on your terminal if 
you specified the command qualifier /NOASSIST, or on the operator terminal if 
you did not specify /NOASSIST: 

%BACKUP-W-MOUNTERR, volume 'number' on 'device' was not mounted because 
its label does not match the one requested 
Specify option (QUIT, NEW tape or OVERWRITE tape) 

BACKUP> 

If you enter QUIT at the BACKUP> prompt, BACKUP aborts, unloads the 
magnetic tape, and issues the following message: 

%BACKUP-F-ABORT, operator requested abort on fatal error 

If you enter NEW at the BACKUP> prompt, BACKUP unloads the magnetic tape 
and issues the following prompt for a new tape: 

%BACKUP- I-READYWRITE, mount volume 'volume-number' on _'device-name': for writing 
Enter "YES" when ready: 

If you enter OVERWRITE at the BACKUP> prompt, BACKUP overwrites the 
old volume label with the new volume label. (OVERWRITE instructs BACKUP 
to ignore the fact that either the tape has not expired or that the labels do not 
match.) By overwriting the tape’s volume label, BACKUP initializes the tape, 
removing access to any data that previously resided on the tape and preparing 
the tape to receive new data. 
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During the initialization process, BACKUP writes the values specified with 
the output save-set qualifiers /TAPE_EXPIRATION, /PROTECTION, and /BY_ 

OWNER to the volume header record. After initializing the tape, BACKUP writes 
the save set to the tape. 

If the tape is not expired, BACKUP displays the following message and prompt 
on your terminal if you specified the command qualifier /NOASSIST, or on the 
operator terminal if you did not specify /NOASSIST: 

%BACKUP-W-MOUNTERR, volume 'number' on 'device' was not mounted because 

its expiration date is in the future 

Specify option (QUIT, NEW tape or OVERWRITE tape) 

BACKUP> 

Always specify /REWIND when the output tape has a non-ANSI or non-ISO label 
or when the output tape has never been initialized. 

The /NOREWIND qualifier directs BACKUP to compare the volume label of the 
tape with the label you specified in the BACKUP command before performing the 
save operation. You can specify a label explicitly with the /LABEL qualifier; 
otherwise, BACKUP uses the first six characters of the save-set name as 
the volume label. If the volume label does not match the label you specified, 
BACKUP displays the following message and prompt on your terminal if you 
specified the command qualifier /NOASSIST, or on the operator terminal if vou 
did not specify /NOASSIST: y 

%BACKUP-W-MOUNTERR, volume 'number' on 'device' was not mounted because 
its label does not match the one requested 
Specify option (QUIT, NEW tape or OVERWRITE tape) 

BACKUP> 

If you choose the OVERWRITE option, BACKUP ignores the fact that the volume 
labels do not match. If the labels match, or if you choose the OVERWRITE 
option, BACKUP winds the tape forward to the logical end-of-tape (the end of the 
last save set stored on the tape) and writes the save set to the tape. If the logical 
end-of-tape is also the physical end of the tape, BACKUP requests a new tape. 
Because BACKUP searches for the end of data on the tape, you cannot write a 

new save set to a tape if it ends with a save set that is continued onto another 
tape. 

Although the /NOREWIND qualifier does not initialize the first tape in a 
multivolume save set, BACKUP initializes subsequent tapes in a multivolume 
save set. BACKUP ensures that the tape is expired and that the tape labels 
match before initializing subsequent volumes in a multivolume save set. 

The default is /NOREWIND. You must specify /REWIND to rewind and initialize 
a magnetic tape volume. Note that you cannot use the /REWIND qualifier with 
the /EXACT.ORDER qualifier. 

Example 

$ BACKUP 
_From: *.RNO 

—To •’ MTAO : DSRSAVE. BCK/REWIND/LABEL=DSR01/TAPE_EXPIRATION=29-JUN-1995 

The command in this example initializes a new magnetic tape and writes 
the volume label DSR01 and a tape expiration date of June 29, 1995 to the 
tape’s volume header record. Then this command saves all files in the current 
default directory with a file type of .RNO to the magnetic tape save set named 
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/SAVE_SET 

Input Save-Set Qualifier 

Directs BACKUP to treat the input file as a BACKUP save set. You must specify 
/SAVE_SET when the input specifier refers to a BACKUP save set on disk. 


Format 

input-save-set-spec/SAVE_SET output-specifier 


Description 

The /SAVE_SET qualifier allows you to refer to a BACKUP save set on a local 
Files-11 disk, a remote Files-11 disk, or a sequential disk. If you do not specify 
/SAVE_SET, an input specifier that refers to a disk is treated as a Files-11 file. 
An input specifier that refers to tape is always treated as a BACKUP save set. 

Examples 

1. $ BACKUP DBA2:[BACKUP]1212MAR3,BCK/SAVE_SET DBA1:[*...] 

T his command restores a save set named 1212MAR3.BCK from DBA2 to 
DBA1. 

2. $ BACKUP/LIST DBA2:[SAVE]23MAR95.BCK/SAVE_SET 

This command lists the BACKUP summary information and the file name, 
size, and creation date for each file in the save set named 23MAR95.BCK. 
The /SAVE_SET qualifier is required to identify the input specifier as a save 
set on a disk. 

3. $ BACKUP/LOG DBA2:[SAVE]23MAR95.BCK/SAVE_SET DBA3:[PLI.WORK] 

This command restores the directory that was listed in Example 2. File 
specifications are logged to SYS$OUTPUT as the files are restored. 


/SAVE_SET 

Output Save-Set Qualifier 

Directs BACKUP to treat the output file as a BACKUP save set. You must specify 
the /SAVEJ3ET qualifier when the output specifier refers to a BACKUP save set 
on disk. 

Format 

input-specifier output-save-set-spec/SAVE_SET 

Description 

The /SAVE_SET qualifier allows you to create a BACKUP save set on a local 
Files-11 disk, a remote Files-11 disk, or a sequential disk. If you do not specify 
/SAVE_SET, an output specifier that refers to disk is treated as a Files-11 file. 
An output specifier that refers to tape is always treated as a BACKUP save set. 
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Examples 

1. $ BACKUP [HILL] DBA1:[BACKUP]SEP28,BCK/SAVE_SET 

This command saves the directory [HILL] to a save set named SEP28.BCK on 
a Files-11 disk. 

2. $ BACKUP DBA2: [PLI.WORK]*.*; [SAVE]23MAR95.BCK/SAVE_SET 

This command saves the highest numbered version of each file in directory 
[PLI.WORK] in a save set named 23MAR95.BCK on the same disk. 

3. $ BACKUP 
_From: [] 

-T°: MILO"FRANKIE THISISMINE"::DUA0:[FRANKIE]MYDIR.BCK/SAVE_SET 

This command saves all files in the current default directory to a network 
save set named MYDIR.BCK on node MILO. 

4. $ MOUNT/FOREIGN DBAO: 

$ BACKUP [SIMS] DBAO:SIMS.BCK/SAVE_SET 

This command saves all files in the directory [SIMS] to a sequential-disk save 
set named SIMS.BCK. 


/SELECT 


Input Save-Set Qualifier 

Selects the specified files for processing. 

Format 

input-save-set-spec/SELECT=(file-spec[,...]) output-specifier 

Description 

If you specify more than one file, separate the file specifications with commas and 
enclose the list in parentheses. Do not use a device specification when you define 
the files to be selected. You can use most standard wildcard characters, but you 
cannot use wildcard characters denoting latest version of files (;) and relative 
versions of files (;-n). 

Note that BACKUP does not apply temporary file specification defaults within 
the list. Each file specification independently takes its defaults from the file 
specification [000000 . . . ]*.*;*. 

Example 


$ BACKUP DBA1:JUL20.BCK/SAVE_SET/SELECT= [SNOW] BALL.PAS [WINTER.GAME]BALL.PAS 

This command selects a file named [SNOW]BALL.PAS from a sequential-disk 
save set and restores it to the directory [WINTER.GAME] on the current default 
device. 


7-59 











BACKUP 

/SINCE 


/SINCE 


Format 


Description 


Input File-Selection Qualifier 

Selects files dated equal to or later than the specified date and time. 


input-specifier/SINCE=time output-specifier 


The /SINCE qualifier selects files by comparing the date and time in the specified 
field of each file header record with the date and time you specify in the command 
line. The following table shows the input file-selection qualifiers you can use with 
/SINCE and their functions. Use only one of these qualifiers at a time in your 
command line. 


Qualifier 

Function 

/BACKUP 

Selects files last saved or copied by BACKUP/RECORD since 

the date specified. Also selects files with no BACKUP date. 

/CREATED 

Selects files created since the date specified. 

/EXPIRED 

Selects files that have expired since the date specified. 

/MODIFIED 

Selects files last modified since the date specified. If you 
specify /SINCE without another qualifier, /MODIFIED is 
used by default. 

Specify the date and time as a delta time or as an absolute time using the format 
[dd-mmm-yyyy[:]][hh:mm:ss.cc]. You can also use one of the following reserved 
words to specify the date and time: 

BACKUP 

The BACKUP/RECORD operation (available only on Files-11 
Structure Level 2 volumes) 

TODAY 

The current day, month, and year at 00:00:00.0 o’clock 

TOMORROW 

24 hours after midnight last night 

YESTERDAY 

24 hours before midnight last night 


Make sure to perform an image backup, using the BACKUP/IMAGE/RECORD 
command, before performing regular incremental backups. The image backup 
saves a copy of the entire disk and marks each file as having been saved. 
Regularly performed subsequent incremental backups assume an image backup 
was already performed and therefore will save new or modified files. If an image 
backup was not performed first, the incremental backups will save more files 
than may be necessary, in an attempt to ensure that an incremental restore will 
be successful. 
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Example 

$ BACKUP [PLI.WORK]/SINCE=YESTERDAY/MODIFIED [PLI.SAV] 

tott “ nd C ° pieS selected files in the directory [PLI.WORK] to the directory 
L LI.SAV], Only those files that have been modified since 24 hours preceding 

night are P rocessed - Even th ough it is used in this example, the 

IE , ( T ahfier 1S not re< l uired because its action is the default when the 
/SINCE qualifier is specified. 


/TAPE.EXPIRATION 


Output Save-Set Qualifier 

Writes a file expiration date other than the current date to the file header label of 
the save set. 

Format 

input-specifier output-save-set-spec/TAPE_EXPIRATION[=date] 

Description 

When you specify the output save-set qualifier /REWIND during a save operation 
to magnetic tape, BACKUP checks that the expiration date of the first file on the 
tape has expired before initializing the tape. Initializing the tape removes access 
to data previously stored on the tape. 

Digital recommends that you specify an expiration date whenever you create 
a BACKUP save set on magnetic tape using /REWIND. Daily BACKUP tapes 
should expire in seven days, weekly BACKUP tapes should expire in one month 
and monthly BACKUP tapes should expire in one year. 

Specify the date in the following format: 

dd:mmm:yyyy 

where: 

dd is the date. 

mmm is a 3-letter abbreviation of the month, 

yyyy is the year. 

BACKUP writes the expiration date into the file’s HDR1 ANSI label on the tape 

If you do not use the /TAPE_EXPIRATION qualifier, BACKUP uses today’s date' 
as the expiration date. 

Example 

$ BACKUP DBA1: 

-T°: MTAO:13SEPBAK.BCK/REWIND/TAPE_EXPIRATION=20-SEP-1994/LABEL=SEPW02 

In this example, the save set file 13SEPBAK.BCK receives an expiration date of 
September 20, 1994. Becauses this command includes the /REWIND qualifier, 
13NOVBAK.BCK is the first file on the tape and its expiration date indicates that 
the tape expires after seven days. 
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/TRUNCATE 

Command Qualifier 

Controls whether a copy or restore operation truncates a sequential output file at 
the end-of-file (EOF) when creating it. 


Format 

/[NO]TRUNCATE input-specifier output-specifier 

Description 

By default, a copy or restore operation uses the allocation of the input file to 
determine the size of the output file. Specify /TRUNCATE if you want the output 
files to be truncated at the end-of-file (EOF). 


Example 


$ DIRECTORY/SIZE [FRANKIE]ORIGINAL.DAT 
Directory DMAO:[FRANKIE] 

ORIGINAL.DAT 35 

Total of 1 file, 35 blocks 

$ COPY ORIGINAL.DAT EXTENDED.DAT/ALLOCATION=500 
$ BACKUP [FRANKIE]EXTENDED.DAT MFAO:20JUL.BCK/LABEL=WKLY03 
$ BACKUP/TRUNCATE MFAO:20JUL.BCK/LABEL=WKLYO3 DMAO:[FRANKIE] 

This sequence of commands does the following: 

• Determines that the file ORIGINAL.DAT is 35 blocks long. 

• Copies ORIGINAL.DAT to EXTENDED.DAT, allocating 500 blocks for 
EXTENDED.DAT. 

• Saves the file EXTENDED.DAT to a save set named 20JUL.BCK on MFAO. 
BACKUP writes the file allocation size in the file header record of the saved 
file but saves only 35 blocks in the save set. 

• Restores the save set file on MFAO to a volume mounted on DMAO and 
truncates the output files at the EOF. The restored file is 35 blocks long. 


/VERIFY 

Command Qualifier 

Specifies that the contents of the output specifier be compared with the contents 
of the input specifier after a save, restore, or copy operation is completed. 

Format 

/VERIFY input-specifier output-specifier 
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Description 

The /VERIFY qualifier is different from the command qualifier /COMPARE. 
Unlike the /VERIFY qualifier, the command qualifier /COMPARE cannot be used 
in a save, restore, copy, or list operation. The /VERIFY qualifier directs BACKUP 
to perform the copy, save, or restore operation first and then to perform the 
compare operation. 

On file-structured copy operations, each file is compared after it is copied. On 
physical copy operations, the volume is compared after it is copied. For a save or 
restore operation, the verification is performed in a separate pass and is preceded 
by the following informational message: 

%BACKUP-I-STARTVERIFY, starting verification pass 

If a file does not compare successfully, BACKUP displays the following error 
message: 

%BACKUP-E-VERIFYERR, verification error for block 'block-number' 
of 'disk:[directory]file_name.file_type;version_number' 

The /VERIFY qualifier does not work on a restore or copy operation when the 
/NEWJVERSION output file qualifier is also used. Because the /NEWJVERSION 
qualifier reassigns output file versions, it is not possible to correctly associate the 
created output files with the input files from which they were copied. 


Example 


$ BACKUP/VERIFY/LOG *.LIS MFAO:LIST.BCK 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]CRE.LIS;1 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]CRETIME.LIS;1 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]EXC.LIS;1 
% BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]NOREB.LIS;1 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]REB.LIS;1 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]SETREB.LIS;1 
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]VERS.LIS;1 

%BACKUP-I-STARTVERIFY, starting verification pass 
%BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]CRE.LIS;1 
%BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]CRETIME.LIS;1 
%BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]EXC.LIS;1 
%BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]NOREB.LIS;1 
% BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]REB.LIS;1 
%BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]SETREB.LIS;1 
%BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]VERS.LIS;1 

This example creates a magnetic tape save set on MFAO and starts the 
verification pass after the save operation is completed. The /LOG qualifier 
displays the file names as they are processed. 


/VOLUME 


Command Qualifier 

Indicates that a specific disk volume in a disk volume set is to be processed. The 
/VOLUME qualifier is valid only when used with the /IMAGE qualifier. 
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BACKUP 

/VOLUME 


Format 

/IMAGE/VOLUME=n input-specifier output-specifier 

Description 

The /VOLUME qualifier allows you to perform an image save, restore, or copy 
operation using one more disk drive than the number of disks in the input volume 
set. When you use /VOLUME, you must write-lock the entire input volume set. 

When you perform an image copy or save operation with the /VOLUME qualifier, 
all disks in the input volume set must be mounted. Mount the volumes of the 
target volume set one at a time. Enter a separate BACKUP command for each 
disk in the input volume set. A save set created with the /VOLUME qualifier 
must be restored using the /VOLUME qualifier. 

You can restore any image save set with the /VOLUME qualifier. All disks in the 
output volume set must be mounted. Mount the disks in the input volume set one 
at a time. You cannot use the command qualifier /NOINITIALIZE in the restore 
operation with the command qualifier /VOLUME. 

In a compare operation that uses the /VOLUME qualifier to compare two disk 
volume sets, all disks in both volume sets must be mounted. In a selected-volume 
compare operation between a save set on tape and a disk volume set, all disks in 
the disk volume set must be mounted. 

Example 

$ BACKUP/IMAGE/V0LUME=3 DISK$PUBLIC DRA1: 

T his command creates a functionally equivalent copy of the third volume of a 
volume set named DISK$PUBLIC to DRA1. The disk mounted in DRA1 becomes 
the third volume of the image-copy volume set. 
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BACKUP Examples 


Table 7-4 shows BACKUP command formats for save operations and some of 
the qualifiers you can use with a save operation. 

Table 7-4 Save Operation Quick Reference 


Command Action 

Command Format and Example 

Saves a file to a save set on 

magnetic tape 

BACKUP file-spec save-set-specifier/LABEL=label 
$ BACKUP STRATDAT1.DAT MTA0:STRATDAT1.BCK 
/LABEL=TAPE01 

Saves the most recent 
versions of files in a directory 
to magnetic tape 

BACKUP [directory]*.*; save-set-specifier/LABEL=label 
$ BACKUP [LYKINS...]*.*; MTA0:1409MAR17.BCK 
/LABEL=WKY102 


Saves a disk volume to a save BACKUP/IMAGE ddcu: save-set-specifier/LABEL=label 


set on magnetic tape 

$ BACKUP/IMAGE DBA1: MTA0:950FEB4.BCK 
/LABEL=MTH101 

Saves a disk volume to a 
multivolume save set on more 
than one magnetic tape drive 

BACKUP/IMAGE ddcu: save-set-specifier,ddcu: . . . 
/LABEL=(labell, . . . ) 

$ BACKUP/IMAGE DBA1: MTA0:17MAR.BCK,MTA1:/ - 
_$ LABEL=(WKY101,WKY102) 

Saves a list of files to a save 
set on magnetic tape 

BACKUP file-spec,file-spec,... save-set-specifier/LABEL=label 
$ BACKUP DBA1:[LYKINS...]*.PAS,DMAO:[DAKOTA...]*.PAS - 
_$ MTA0:PAS17MAR.BCK/LABEL=TAPE01 

Saves a disk volume for 
incremental backups for the 
first time 

BACKUP/RECORD/IMAGE/LOG ddcu: save-set-specifier 
/LABEL=label 

$ BACKUP/RECORD/IMAGE/LOG DBA1: MTA0:925FEB4.BCK 
/- 

_$ LABEL=DLY101 

Saves a disk volume for 
incremental backups (not the 
first time) 

BACKUP/RECORD/FAST/LOG ddcu:[*...]/SINCE-BACKUP 
save-set-specifier/LABEL=label 

$ BACKUP/RECORD/FAST/LOG DBA1:[*...]/SINCE=BACKUP - 
_$ MTA0:928FEB4.BCK/LABEL=DLY101 

Saves an unstructured disk 
volume 

BACKUP/PHYSICAL ddcu: save-set-specifier/LABEL=label 
$ BACKUP/PHYSICAL DMA1: MTA0:955FEB4.BCK 
/LABEL=MTH101 

(continued on next page) 
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BACKUP Examples 


Table 7-4 (Cont.) Save Operation Quick Reference 


Command Action 

Command Format and Example 

Saves a directory to a save 
set on a Files-11 disk 

BACKUP [directory] save-set-specifier/SAVE_SET 

$ BACKUP [LYKINS] DBA2:[BACKUP]1609FEB3.BCK/SAVE_ 

SET 

Saves a directory tree to a 
save set on magnetic tape 

BACKUP [directory...] save-set-specifier/LABEL=label 
$ BACKUP [LYKINS...] MTA0:1612FEB3.BCK/LABEL=TAPE01 

Saves a directory tree to a 
save set on magnetic tape 
and creates a listing file 

BACKUP/LIST=file-spec [directory...] save-set-specifier 
/LABEL=label 

$ BACKUP/LIST=8SEP.LOG [LYKINS...] MTA0:8SEP.BCK 
/LABEL=WKL101 

Saves a directory tree to a 
save set on magnetic tape 
using data compaction to 
increase the amount of data 
stored on a tape cartridge 

BACKUP [directory...] save-set-specifier/MEDIA_ 
FORMAT=COMPACTION 

$ BACKUP [TESTFILES...]*.*;* MUAO:TEST.SAV/MEDIA_ 
FORMAT=COMPACTION/REWIND 


Table 7-5 shows BACKUP command formats for restore operations and some 
of the qualifiers you can use with restore operations. In the examples in this 
table, it is assumed that save sets already exist on the magnetic tape and 
disk. 

Table 7-5 Restore Operation Quick Reference 


Command Action 

Command Format and Example 

Restores from save set on 
disk to Files-11 disk with 
original UICs 

BACKUP save-set-specifier/SAVE_SET ddcu:[*...]/BY_ 
OWNER=ORIGINAL 

$ BACKUP DBA2:[BACKUP]FEB2,BCK/SAVE_SET DBA1:[*...]- 
_$/BY_OWNER=ORIGINAL 

Restores from a save set on 
magnetic tape to a Files-11 
disk with original UICs 

BACKUP save-set-specifier ddcu:[*...]/BY_OWNER=ORIGINAL 
$ BACKUP MTA0:1618FEB2.BCK DBA1:[*...]/BY_ 
OWNER=ORIGINAL 

Restores a selected file in a 
save set on magnetic tape to 
a Files-11 disk 

BACKUP save-set-specifier/SELECT=file-spec file-spec 
$ BACKUP MTAO:FEB2.BCK/SELECT=[POUDRE]UPLIFT.PAS 

_$ DBAl:[GEO.PAS]UPLIFT.PAS 


(continued on next page) 
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Table 7-5 (Cont.) Restore Operation Quick Reference 


Command Action 

Command Format and Example 

Restores files with a specific 
UIC to a Files-11 disk 

BACKUP save-set-specifier/BY OWNER=[uic] file-spec 
$ BACKUP MTAO: 1641FEB2.BCK/BY OWNER=[360 052] - 
_$ DBA1:[LYKINS...] 

Restores files to a Files-11 
disk with a new UIC 

BACKUP save-set-specifier file-spec/BY OWNER=[uic] 

$ BACKUP MTA0:1641FEB2.BCK - 
_$ DBA1:[TESTS...]/BY_OWNER=[100,150] 

Restores files to a Files-11 
disk; if file exists, creates 
new version 

BACKUP save-set-specifier file-spec/NEW VERSION 
$ BACKUP MTA0:1641FEB2.BCK DBA1:[LYKINS...]/NEW 

VERSION 

Restores files to a Files-11 
disk; if file exists, replaces 
with new version 

BACKUP save-set-specifier file-spec/REPLACE 
$ BACKUP MTAO: 1641FEB2.BCK DBA1:[LYKINS...]/REPLACE 

Restores files to a Files-11 
disk selecting certain files 

BACKUP save-set-specifier/SELECT=file-spec file-spec 
$ BACKUP MTA0:1641FEB2.BCK/SELECT=[LYKINS PAS] - 
_$ DBA1:[LYKINS...] 

Restores a directory tree, 
placing files in a different 
subtree 

BACKUP save-set-specifier/SELECT=[directory...] [directory2...] 

$ BACKUP MTA0:1641FEB2.BCK/SELECT=[FIELD ] - 
_$ DBA1:[LYKINS.NEWDATA...] 

Restores a Files—11 volume 
from a physical save set 

BACKUP/PHYSICAL save-set-specifier ddcu: 

$ BACKUP/PHYSICAL MTA0:26MAR.BCK DMA3: 

Restores a Files-11 volume 
from an image save set 

BACKUP/IMAGE save-set-specifier ddcu: 

$ BACKUP/IMAGE MTA0:17AUG.BCK DRA3: 

Restores a Files-11 volume, 
maintaining the initialization 
parameters specified in the 
DCL command INITIALIZE 

INITIALIZE ddcu: volume-name/new-parameters 

MOUNT/FOREIGN ddcu: 

BACKUP/IMAGE save-set-specifier ddcu:/NOINITIALIZE 
$ INITIALIZE DBA1: UTTLPACK/CLUSTER=5 
$ MOUNT/FOREIGN DBA1: 

$ BACKUP/IMAGE MTA0:17AUG.BCK DBAL/NOINITIALIZE 
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Table 7-6 shows BACKUP command formats for copy operations, including 
some of the qualifiers you can use with a copy operation. 


Table 7-6 Copy Operation Quick Reference 


Command Action 

Command Format and Example 

Copies a directory tree to 
another directory tree 

BACKUP [directory...] [directory...] 

$ BACKUP [DAKOTA...] [SUNDANCE...] 

Copies a file to another file 

BACKUP file-spec file-spec 

$ BACKUP LOGIN.COM [.SAVE]OLDLOGIN.COM 

Copies a disk volume to 
another disk volume 

BACKUP/IMAGE ddcu: ddcu: 

$ BACKUP/IMAGE DBA1: DBA2: 

Copies a disk volume to 
another disk volume using 
the /PHYSICAL qualifier 

BACKUP/PHYSICAL ddcu: ddcu: 

$ BACKUP/PHYSICAL DYA1: DYA2: 

Copies two disk volume sets 
using the /IMAGE qualifier 

BACKUP/IMAGE volume-set-name ddcu:,ddcu: 

$ BACKUP/IMAGE USER$: DBA1:,DBA2: 

Table 7-7 shows BACKUP command formats for compare operations, 
including some of the qualifiers you can use with a compare operation. 

Table 7-7 Compare Operation Quick Reference 

Command Action 

Command Format and Example 

Compares two Files-11 files 

BACKUP/COMPARE file-spec file-spec 
$ BACKUP/COMPARE UPLIFT.EXE;3 UPLIFT.EXE;2 

Compares a selected file from 
a save set and a Files—11 file 

BACKUP/COMPARE save-set-specifier/select=file-spec file-spec 
$ BACKUP/COMPARE MTA0:FEB2.BCK 
/SELECT=[POUDRE]UPLIFT.PAS - 
_$ UPLIFT.PAS 

Compares an image save set 
and Files-11 files 

BACKUP/COMPARE/IMAGE save-set-specifier ddcu: 

$ BACKUP/COMPARE/IMAGE MTA0:12OCT.BCK DRA3: 
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Table 7-8 shows BACKUP command formats for a list operation, including 
some of the qualifiers you can use with a list operation. 

Table 7-8 List Operation Quick Reference 


Command Action 

Command Format and Example 

Lists the files in a save set at 
the terminal 

BACKUP/LIST save-set-specifier 
$ BACKUP/LIST MTA0:1618FEB2.BCK 

Lists the files in a save set, 
writes to a file 

BACKUP/LIST=file-spec save-set-specifier 
$ BACKUP/LIST=NEWLIST.LIS MTA0:1618FEB2.BCK 

Lists the files in a save set in 
full format 

BACKUP/LIST/FULL save-set-specifier 
$ BACKUP/LIST/FULL MTA0:1618FEB2.BCK 

Lists selected files in a 
journal file 

BACKUP/LIST/JOURNAL=journal-name/selection-qualifiers 
$ BACKUP/LIST/JOURNAL=SYS$MANAGER:INCBACKUP - 
_$/SELECT=[LYKINS.WORK.. ,]/SINCE=l-JAN-1995 
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Crash Log Utility Extractor (CLUE) (VAX Only) 










CLUE Description (VAX Only) 


Alpha 


On VAX systems, you can use the Crash Log Utility Extractor (CLUE) to display 
the contents of a crash history file. The crash history file, which is created 
and updated by CLUE, contains key parameters from crash dump files. Unlike 
crash dumps, which are overwritten with each system failure (crash) and are 
therefore typically available only for the most recent failure, the crash history file 
is a permanent record of system failures. By examining the contents of the crash 
history file with the CLUE/DISPLAY command, you can understand and resolve 
the issues responsible for some crashes and you can also obtain other useful data. 

On Alpha systems, CLUE features are provided through System Dump Analyzer 
(SDA) utility commands Refer to the OpenVMS AXP System Dump Analyzer 
Utility Manual for more information. ♦ 
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CLUE Usage Summary (VAX Only) 

When a system fails, physical memory is copied to the crash dump file, 
and CLUE automatically appends the relevant parameters to a file named 
CLUE$OUTPUT:CLUE$HISTORY.DATA. You can use CLUE to display and 
examine the data in this file. 


Format 

CLUE /DISPLAY 

Parameters 

None. 

Usage Summary 

Before you run CLUE, define the CLUE command (either interactively or in a 
procedure such as a login command procedure), as follows: 

$ CLUE :== $CLUE 

To invoke CLUE, enter the CLUE/DISPLAY command. To terminate CLUE, enter 
the EXIT command at the CLUE_DISPLAY> prompt or press Ctrl/Z. 

Note that you can also issue CLUE/DISPLAY commands directly from DCL, as in 
the following example: 

$ CLUE/DISPLAY = DIR/TYPE=INVEXCEPTN/SINCE=21-NOV-1994/OUT=CLUE.LIS 
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CLUE (VAX Only) 


CLUE Commands (VAX Only) 

This section describes and provides examples of the CLUE /DISPLAY commands. 
You can abbreviate any command, keyword, or qualifier as long as the 
abbreviation is not ambiguous. The asterisk and the percent sign can be used as 
wildcard characters in the specification of user names, node names, and UICs. 

Table 8-1 lists the commands described in this section. 

Table 8-1 CLUE Commands (VAX Only) 

Command Description 

Deletes an entry from the crash history file 
Displays a list of entries from the crash history file 
Exits from CLUE 

Extracts data from an entry in the crash history file to a file 
Provides online help for CLUE/DISPLAY commands 
Displays specific information for an entry in the crash history file 


DELETE 

DIRECTORY 

EXIT 

EXTRACT 

HELP 

SHOW 


DELETE (VAX Only) 

Deletes an entry from the list and writes the remaining entries to a binary file. 

Format 

DELETE n 

Parameter 

n 

The number of the entry that you want to delete from the crash history file. The 
number of the entry corresponds to the entry number shown by the DIRECTORY 
command. 

Description 

Entries in the CLUE.BIN file can be permanently removed using the DELETE 
command. This command deletes the specified entry and writes the remaining 
entries to an output file. When an entry is deleted from the crash history file, a 
new history file (with a higher version number) is created. 

Example 


CLUE_DISPLAY> DELETE 4 

Deletes the fourth entry in the list. 
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CLUE (VAX Only) 
DIRECTORY (VAX Only) 


DIRECTORY (VAX Only) 

Displays a brief summary of each entry in crash history file. 


Format 


DIRECTORY 


Qualifiers 


/MODULE= 

Lists all failures that correspond to the specified module (that is, failures that 
start with the specified string). 

/OFFSET= 

Lists all failures that correspond to the specified offset (that is, failures that start 
with the specified string). 

/SINCEs 

Lists all failures that have occurred since the specified date. If the /SINCE 
qualifier is used and no date is specified, all failures that have occurred on the 
current day are listed. 

/TYPEs 

Lists all failures that correspond to the specified type (that is, failures that start 
with the specified string). 


Description 

The DIRECTORY command lists the record entries in the crash history file, 
beginning with the most recent entry. Six headings are displayed for each entry: 

• Entry number 

• Date and time of crash 

• Type 

• Process 

• Module 

• Offset 

You can use one or more qualifiers for the DIRECTORY command to limit the 
crash entries that are displayed. You can also use more than one qualifier in the 
same command line. For example, the command DIRECTORY/SINCE=18-APR- 
1994/MODULE=NETACP lists only those crash entries that have taken place 
since April 18, 1994, and for which the module is NETACP. 
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CLUE (VAX Only) 
DIRECTORY (VAX Only) 


Examples 

1. CLUE_DISPLAY> DIRECTORY 

Process name Module Offset 

batman NETACP 14B9 

startrek SYSLOA 10A8 

evolushun NONE NONE 

aprocess IOBUF 015D 

This example lists all entries in the crash history file. 

2. CLUE_DISPLAY> DIRECTORY /M0DULE=SYSL0A 

# Process name Module Offset 

2 01-JAN-1995 11:32:55.23 SSRVEXCEPT startrek SYSLOA 10A8 

This example lists only those entries for which the module is SYSLOA. 

EXIT (VAX Only) 


# Time 

1 ll-JUL-1994 09:07 

2 01-JAN-1995 11:32 

3 15-MAY-1994 07:26 

4 22-APR-1994 10:45 


Type 


:45.78 INVEXCEPTN 
55.23 SSRVEXCEPT 
12.34 BADFID 
20.60 INVEXCEPTN 


Exits from CLUE. 

Format 


EXIT 

Description 

This command exits from CLUE and returns you to the DCL level. 

Example 

CLUE_DISPLAY> EXIT 

$ 

This example exits from CLUE. 

EXTRACT (VAX Only) 


Extracts all of the data from an entry in the crash history file to either an ASCII 
or a binary file. 


Format 

EXTRACT n 

Parameter 

n 

The number of the entry that you want to extract to a file. The number of the 
entry corresponds to the entry number shown by the DIRECTORY command. 
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CLUE (VAX Only) 
EXTRACT (VAX Only) 


Qualifiers 

/BINARY=filename.bin 

The /BINARY qualifier writes the output to a binary file. 


/OUTPUT=filename.txt 

The /OUTPUT qualifier writes the output to an 
qualifier is the default. 


ASCII file. The /OUTPUT 


Description 

Use the EXTRACT command to save record entries from the crash history file to 
an ASCII or a binary file. If no qualifier is used, entry is written to a text file 
with the name CLUE$HISTORY.TXT. 

Example 

CLUE_DISPLAY> EXTRACT 3 /0UTPUT=15MAYCRASH.TXT 

This command writes the data from entry number 3 in the crash history file to an 
ASCII file named 15 MAYCRASH.TXT. 


HELP (VAX Only) 

Provides online help for CLUE commands. 

Format 

HELP [command] 

Parameter 

command 

The command for which you want help. 

Example 

CLUE_DISPLAY> HELP DIRECTORY 

This command provides online help for the DIRECTORY command in CLUE. 


SHOW (VAX Only) 

Displays specific information for an entry in the crash history file. 


Format 

SHOW info_type n 


8-8 







CLUE (VAX Only) 
SHOW (VAX Only) 


Parameters 


info_type 

You must choose one of the following information types: 

• CRASH—displays information similar to the SHOW CRASH command in the 
System Dump Analyzer (SDA) utility. 

• STACK—displays information similar to the SHOW STACK command in 
SDA. 

• EXEC—displays information similar to the SHOW EXEC and SHOW 
DEVICE commands in SDA. 


ISTREAM—displays the instruction stream around the failing PC. 

SUMMARY—displays the active processes on the system, similar to the 
SHOW SUMMARY/IMAGE command in SDA. 

• ALL—displays all the information from the preceding types. 

For more information about SDA commands, see the OpenVMS VAX System 
Dump Analyzer Utility Manual. 


n 

The number of the entry for which you want to display information. The 
number of the entry corresponds to the entry number shown by the DIRECTORY 
command. 


Description 

This command lets you see all the data associated with a particular failure. This 
information is split into several sections; you can choose to see either individual 
sections or all of the information. 

If the crash number is not specified, information for the most recent entry in the 
crash history file is displayed. You must, however, specify one of the keywords for 
infojype. 

If you request a specific entry from the crash history list (using the SHOW n 
command), the display will include some parameters that are useful only to 
Digital service representatives. 


Examples 


1. CLUE_DISPLAY> SHOW ISTREAM 4 

Instructions around the failing PC: 
80A9F841 RSB 

80A9F842 BUG_CHECK #019C 
80A9F846 BUG_CHECK #019C 
80A9F84A PUSHL R4 

80A9F84C MOVL R5,R4 

80A9F84F BEQL 00002C88 
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CLUE (VAX Only) 
SHOW (VAX Only) 


80A9F851 JSB @#-7FFFCC48 

80A9F857 MOVL (SP)+,R4 

80A9F85A RSB 

80A9F85B BUG_CHECK #019C 

PC->80A9F85F BUG_CHECK #019C => CLUSTRLOA + 09B6F 

80A9F863 MOVL #00,Rl 

80A9F866 MOVB #01,R0 

80A9F869 RSB 

80A9F86A INCL 00002301 

80A9F86E TSTW 000022FF 

80A9F872 BLSS 00002CA5 

This example displays instruction stream information around the failing PC 
from the crash history file for entry number 4. 


2. CLUE_DISPLAY> SHOW CRASH 4 

Time of system crash: 

Version of system: 

System Version Major ID/Minor ID: 
VAXcluster node: 

Crash CPU ID/Primary CPU ID: 
Bitmask of CPUs active/available: 
CPU bugcheck codes: 

Current Process name: 

Current IPL: 

CPU database address: 

General registers: 

R0 = 80A9F85B Rl = 00000002 

R4' = 80A15AD0 R5 = 00000000 

R8 = 00022520 R9 = 00020F18 


21-MAR-1994 15:21:33.72 
VAX/VMS VERSION V5.5 
1/0 

HERMES, a VAX 6000-420 
03/01 

OOOOOOOA/OOOOOOOA 
CPU 03 INCONSTATE 

1 other CPUEXIT 

OPCOM 
8 

801AA000 


R2 = 80A15B08 R3 = 00010008 
R6 = 00000001 R7 = 00000042 
R10 = 00021000 Rll = 00020EC0 


This example displays information about the state of the system at the time 
of the failure. The actual output from this command may contain significantly 
more information than is shown in this example. 
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DECevent Utility Description (DECevent) (Alpha Only) 

On Alpha, the DECevent utility is an event management utility that provides 
the interface between a system user and the operating system’s event log files. 

is allows system users to produce ASCII reports derived from system event 
entries. The format of the ASCII reports depends on the command entered on the 
command line interface (CLI) with a maximum character limit of 255 characters. 

DECevent uses the system event log file, SYS$ERRORLOG:ERRLOG.SYS, as the 
default input file, unless another input file is specified. 


9-3 








DECevent Utility Usage Summary (Alpha Only) 

-t-vt-i i i * 1 * J J — 1 /\ nnn /~ir\ 4" C< /"VT /TT1 


The DECevent utility translates the contents of one or more event log files for 
inclusion into a report. DECevent generates five types of reports: full (default), 
brief, terse, summary, and FSTERR. These report types are mutually exclusive 
when selected within a command; no combinations are allowed. 


Format 


DIAGNOSE/TRANSLATE [/qualifier(s)][file-spec[,...]] 

Parameters 

/qualifier(s) , 

The function to be performed by the DIAGNOSE/TRANSLATE command. 

fil6”Sp6C[j...] 

Specifies one or more files that contain binary error information to be 
translated for the specified report. You can include wildcard characters in 
the file specification. If you omit the file specification, the default file is 
SYS$ERRORLOG:ERRLOG.SYS (see the OpenVMS System Manager’s Manual 
for information on maintaining this file). 

See the OpenVMS User’s Manual for details on file specifications. 

Usage Summary 

To invoke DECevent, enter the following DCL command: 

DIAGNOSE [/qualifier(s)] [file-spec][,..] 

Note that typing the /TRANSLATE qualifier on the command line is not necessary 
because it is the default report qualifier. DECevent does not prompt you. To exit 
from DECevent, press Ctrl/C and the Return key (to receive the system prompt). 

You must have SYSPRV privilege to run DECevent; however, only read access 
is required to access the ERRLOG.SYS file. You must have the DIAGNOSE 
privilege for the /CONTINUOUS qualifier to work, enabling the continuous 
display of events on a terminal screen. Do not use the /BINARY qualifier with 
any report type qualifier (/FULL, /BRIEF, /TERSE, /SUMMARY, and /FSTERR) 
or with the /OUTPUT qualifier. 
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DECevent Utility Qualifiers (Alpha Only) 

The qualifiers for the DIAGNOSE/TRANSLATE command are described in this 
section. Table 9—1 lists the qualifiers. 


Table 9-1 DECevent Qualifiers (Alpha Only) 


Qualifier 

Description 

/BEFORE 

Specifies that only those entries dated earlier than the stated 
date and time are to be selected for the event report 

/BINARY 

Controls whether the binary error log records are converted to 
ASCII text or copied to the specified output file 

/BRIEF 

Generates a brief report 

/CONTINUOUS 

Specifies that events are formatted in real time, as they are 
logged by the operating system event logger 

/DUMP 

Specifies the output to be a brief report followed by a dump of 
information from the input event log file 

/ENTRY 

Generates a report that includes the specified entry range or 
starts at the specified entry number 

/EXCLUDE 

Excludes events generated by the specified device class, device 
name, or error log entry type from the report 

/FSTERR 

Generates a quick, one-line-per-entry report of an event log 
entry for disks and tapes 

/FULL 

Generates a full report (default), which provides all available 
information for an event log entry 

/INCLUDE 

Includes events generated by the specified device class, device 
name, or error log entry type in the report 

/INTERACTIVE 

Allows users to exit from the command line interface and enter 
the DECevent interactive command shell 

/LOG 

Controls whether informational messages that specify the 
number of entries selected and rejected for each input file are 
sent to SYS$OUTPUT 

/NODE 

Generates a report consisting of event entries for specific nodes 
in a VMScluster system 

/OUTPUT 

Specifies the output file for the report 

/REJECTED 

Allows you to specify the name of a file that will contain binary 
records for rejected entries 

/SINCE 

Specifies that only those entries dated later than the stated 
date and time are to be selected for the report 

/SUMMARY 

Generates an event report that consists of a statistical 
summary 

/TERSE 

Generates an event report consisting of binary event 
information, register values, and ASCII messages in a 
condensed format 

/TRANSLATE 

Is the default qualifier for the DIAGNOSE command verb 


In addition to the qualifiers listed in Table 9—1, the DECevent utility contains a 
set of DIRECTORY commands and a set of SHOW commands. 

DIRECTORY commands allow a user to display a list of rulesets that DECevent 
requires for translating events into user-readable format. 


9—5 












DECevent (Alpha Only) 


The DIRECTORY commands currently implemented in DECevent are 
DIRECTORY EVENT and DIRECTORY CANONICAL. 

The SHOW commands allow a user to view specific settings and selections. The 
SHOW commands currently implemented in DECevent are SHOW SELECT and 
SHOW SETTINGS. By appending a specific selection keyword name to the SHOW 
SELECT command, you view only that specific selection keyword. By appending 
a specific setting’s name to the SHOW SETTINGS command, you view only that 
specific setting’s name and value. 


/BEFORE (Alpha Only) 

Specifies that only those entries dated earlier than the stated date and time are 
to be selected for the report. 


Format 

/BEFORE [=date-time] 

Parameter 

date-time 

Limits the report to those entries dated earlier than the specified time. 

Description 

You can specify an absolute time, a delta time, or a combination of absolute and 
delta times. See the OpenVMS User’s Manual for details on specifying times. 

If you omit the /BEFORE qualifier or specify /BEFORE without a date or time, 
all entries are processed. 

Example 

$ DIAGNOSE/TRANSLATE/BEFORE=19-APR-1994:10:00 ERRLOG.OLD;5 

In this example, the full (default) report generated for ERRLOG.OLD;5 contains 
entries that were logged before 10:00 A.M. on April 19, 1994. 


/BINARY (Alpha Only) 

Controls whether the binary error log records are converted to ASCII text or 
copied to the specified output file. 


Format 

/BINARY [=file-spec] 

Parameter 

file-spec 

Specifies the output file selected to contain image copies of the input records. 
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Description 

The /BINARY qualifier creates a binary file that contains copies of the original 
binary event log entry if the command line also specifies an interval (/SINCE 
/BEFORE, or /ENTRY qualifier) or a filter (/INCLUDE or /EXCLUDE qualifier). 
If no interval or filter is specified, all event log entries are copied. 

If you specify /BINARY=file-spec, the selected output file contains image copies of 
the binary input records (the records are not translated to ASCII). If you omit the 
device or directory specification, the current device and the default directory are 
used. If you omit the file name, the file name of the input file is used. If you omit 
the file type, the default file type is .DAT. 

Do not use /BINARY with the /BRIEF, /FSTERR, /FULL, /OUTPUT, /SUMMARY, 
or /TERSE qualifiers. These qualifiers generate an ASCII report; /BINARY 
generates a binary file. 

Example 

$ DIAGNOSE/TRANSLATE/INCLUDE=DBA1/BINARY=DBA1_ERR.DAT ERRLOG.OLD;5 

In this example, the output file DBA1_ERR.DAT contains image copies of the 
entries that apply to DBA1. 


/BRIEF (Alpha Only) 

Generates a brief report. 

Format 

/BRIEF 

Description 

Do not use /BRIEF with the /BINARY qualifier. 

Example 9-2 shows the format of a typical brief error log report. 

Example 

$ DIAGNOSE/TRANSLATE/BRIEF ERRLOG.OLD;97 

In this example, the brief report generated from ERRLOG.OLD;97 contains 
minimal information. 


/CONTINUOUS (Alpha Only) 

Allows events to be displayed on a terminal screen, in real time, as the events are 
logged by the operating system’s event logger. 
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/CONTINUOUS (Alpha Only) 

Format 

/CONTINUOUS 


Description 

The /CONTINUOUS qualifier specifies that events are formatted as they are 
logged by the operating system event logger in real time. No input file can be 
specified The real-time output is directed to the terminal screen by default. You 
may redirect the real-time output to a file, specified with the /OUTPUT qualifier. 
Use the /BRIEF report type with the /CONTINUOUS qualifier. 


Example 


$ DIAGNOSE/TRANSLATE/CONTINUOUS/BRIEF/OUTPUT=ERRLOG.CONT 

In this example, the brief report containing real-time event logger information 
generated from the default input event log file, SYS$ERRORLOG:ERRLOG.SYS, 
has been directed to the output file ERRLOG.CONT. 


/DUMP (Alpha Only) 

Allows a user to dump out criteria, selected by qualifiers, from the input event log 
file. 


Format 

/DUMP 

Description 

The /DUMP qualifier allows users to selectively dump information from the input 
event log file. The resulting output is a brief report type, followed by a dump of 
the canonical buffer for the input event. 

Example 

$ DIAGNOSE/TRANSLATE/DUMP/INCLUDE=(RA9 0) ERRLOG.OLD;97/0UTPUT=97.OUT 

In this example, the brief report generated from ERRLOG.OLD;97 contains 
information about RA90 disk drives. The report has been directed to the output 
file 97.0UT. 


/ENTRY (Alpha Only) 

Generates a report that includes the specified entry range or starts at the 
specified entry number. 

Format 

/ENTRY [=(START:decimal-value[,END:decimal-value])] 
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Parameter 


(START:decimal-value[,END:decimal-value]) 

Specifies the range of entries to be included in the report. 

Description 


If you specify /ENTRY without the entry range or omit the 
range defaults to START: l,END:end-of-file. 


qualifier, the entry 


Example 


$ DIAGNOSE/TRANSLATE/ENTRY=(START:1,END:18) ERRLOG.SYS 

ppmopovo 6 ’ the entry range for the full (default) report generated from file 
JiKKLUO.bYb is limited to entry numbers 1 to 18. 


/EXCLUDE (Alpha Only) 


Excludes errors generated by the specified device class, device name, or event 
entry type from the report. 

Format 

{ device-class ) 
device-name > [,...]) 
entry-type J 


Parameters 

device-class 

device-name 

entry-type 

Specifies one or more keywords denoting the device class, device name, or 
event log entry type. If you specify more than one keyword, you must specify a 
comma-separated list of values that is enclosed in parentheses. 

Device Class Keywords 

ADAPTER 

BUSES 

CACHE 

DISKS 

INFORMATIONAL 

LINE_PRINTER 

REALTIME 

SYNC_COMMUNICATIONS 

TAPES 

VECTOR 

WORKSTATION 
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Examples of Device Name Constructs 

DB Group of devices 

Specific device/unit number 
(DBA1,HSC1$DUA1,DYA0) List of devices 

(DB,DR,XF) List of device groups 


Entry-Type Keywords 

ATTENTIONS 

BUGCHECKS 

CONFIGURATION 

CONTROL_ENTRIES 


Exclude device attention entries from the report. 
Exclude all types of bugcheck entries from the 
report. 

Exclude system configuration entries from the 
report. 

Exclude control entries from the report. Control 
entries include the following entry types: 


• System power failure restarts 

• Time stamps 

• System startups 

• $SNDERR messages (system service to send 
messages to error log) 

• Operator messages 

• Network messages 

• ERRLOG.SYS created 


CPU_ENTRIES 


Exclude CPU-related entries from the report. 
CPU entries include the following entry types: 


• SBI alerts/faults 

• Undefined interrupts 

• MBA/UBA adapter errors 

• Asynchronous write errors 

• UBA errors 


DEVICE_ERRORS 

ENVIRONMENTAL. 

ENTRIES 

MACHINE.CHECKS 

MEMORY 

SNAPSHOT.ENTRIES 

SYNDROME 

TIMEOUTS 


Exclude device error entries from the report. 
Exclude environmental entries from the report. 

Exclude machine check entries from the report. 
Exclude memory errors from the report. 

Exclude snapshot entries from the report. 
Exclude console-generated entries that describe 
a symptom set used by Digital support personnel 
to identify problems. 

Exclude device timeout entries from the report. 
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UNKNOWN_ENTRIES 

UNSOLICITED.MSCP 

VOLUME_CHANGES 


Exclude any entry that had either an unknown 
entry type or an unknown device type or class. 

Exclude unsolicited MSCP entries from the 
output report. 

Exclude volume mount and dismount entries 
from the report. 


Description 

You can specify one or more devices by device class, device name, or one or more 
keywords that identify entry types. 

Unless you specify the UNKNOWN.ENTRIES keyword to explicitly exclude from 

a report any entries from unsupported (unknown) devices, any unknown device is 
reported. 

Any known information for the entry is translated; the remaining information is 
output in hexadecimal longwords. 


If you specify a device class keyword or a device name construct with both the 
/INCLUDE and /EXCLUDE qualifiers, the /INCLUDE qualifier takes precedence. 


The BUSES keyword also excludes event log entries for the BI bus. The 
DEVTCE_ERRORS keyword also excludes entries for the BI adapter. 


Examples 


1. $ DIAGNOSE/TRANSLATE/EXCLUDE=MTAO 

In this example, entries for the device MTAO are excluded from the full 
(default) report for the file ERRLOG.SYS. 


2. $ DIAGNOSE/TRANSLATE/EXCLUDE=(MTAO,DRA5) ERRLOG.OLD 

In this example, the devices MTAO and DRA5 are excluded from the full 
(default) report for the file ERRLOG.OLD. 

3. $ DIAGNOSE/TRANSLATE/EXCLUDE=(DISKS,BUGCHECKS) 

In this example, all disk devices and all bugcheck entries are excluded from 
the full (default) report for the file ERRLOG.SYS. 


4. $ DIAGNOSE/TRANSLATE/EXCLUDE=TAPES/INCLUDE=MTAO 

In this example, the device MTAO is included in the full (default) report for 

the file ERRLOG.SYS. All other magnetic tape devices are excluded from the 
report. 

5. $ DIAGNOSE/TRANSLATE/EXCLUDE=(DISKS,VOLUME_CHANGES) 

In this example, entries for disks and entries for all volume information are 
excluded from the full (default) report for the file ERRLOG.SYS. 

6. $ DIAGNOSE/TRANSLATE/EXCLUDE=(DISKS,VOLUME_CHANGES,DEVICE_ERRORS) 

In this example, entries for all volume changes, for all disks, and for all device 
error information on disks are excluded from the full (default) report for the 
file ERRLOG.SYS. 
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/EXCLUDE (Alpha Only) 

7. $ DIAGNOSE/TRANSLATE/EXCLUDE=(DISKS,VOLUME_CHANGES,DEVICE_ERRORS,BUGCHECKS) 

In this example, all entries for disks, all entries for volume changes, all 
entries for device error information on disks, and all entries for bugcheck 
errors are excluded from the full (default) report for the file ERRLOG.SYS. 

/FSTERR (Alpha Only) 

Generates a quick, one-line-per-entry report for various disk and tape devices. 

Format 

/FSTERR 

Description 

The FSTERR report provides the information that Digital support personnel need 
when troubleshooting tape or disk device problems. 

Do not use /FSTERR with the /BINARY qualifier. 

The Example section shows the format of a typical FSTERR report. 

Example 

$ DIAGNOSE/TRANSLATE/FSTERR ERRLOG.OLD;72 

In this example, the command produces a FSTERR report for tape and disk 
devices from information contained in the event log ERRLOG.OLD;72. 


/FULL (Alpha Only) 

Generates a full report, which provides all available information for an event 
entry. This is the default report format. 

Format 

/FULL 


Description 

The full report format provides a translation of all available information for each 
entry in the event log. The full report is the default report type if a report type is 
not specified in the command line. 

Do not use /FULL with the /BINARY qualifier. 

Examples 

1. $ DIAGNOSE/TRANSLATE/FULL ERRLOG.OLD;72 

In this example, the command produces a full (default) report. 

2. $ DIAGNOSE/TRANSLATE ERRLOG.OLD;72 

In this example, the command produces a full (default) report. The default 
report type is /FULL; it is not necessary to specify it in the command line. 


9-12 








DECevent (Alpha Only) 
/INCLUDE (Alpha Only) 


/INCLUDE (Alpha Only) 


Includes events generated by the specified device class, device name, or event log 
entry type in the report. 


Format 


device-class 


/INCLUDE=( < device-name > [,...]) 
( entry-type I 


Parameters 


device-class 

device-name 

entry-type 

Specifies one or more keywords denoting the device class, device name, or entry 
type. If you specify more than one keyword, you must specify a comma-separated 
list of values that is enclosed in parentheses. 

Device Class Keywords 

ADAPTER 

BUSES 

CACHE 

DISKS 

INFORMATIONAL 

LINE.PRINTER 

REALTIME 

SYNC_COMMUNICATIONS 

TAPES 

VECTOR 

WORKSTATION 

Examples of Device Name Constructs 


DB 

DBA1 

(DBA1,HSC1$DUA1,DYA0) 

(DB,DR,XF) 

Entry-Type Keywords 

ATTENTIONS 

BUGCHECKS 

CONFIGURATION 


Include device attention entries in the report. 
Include all types of bugcheck errors in the report. 

Include system configuration entries in the 
report. 


Group of devices 
Specific device/unit number 
List of devices 
List of device groups 
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CONTROLJENTRIES 


CPU_ENTRIES 


DEVICE_ERRORS 

ENVIRONMENTS 

ENTRIES 

MACHINE.CHECKS 

MEMORY 

SNAPSHOT_ENTRIES 

SYNDROME 

TIMEOUTS 

UNKNOWN_ENTRIES 

UNSOLICITED_MSCP 

VOLUME_CHANGES 


Include control entries in the report. Control 
entries include the following entry types: 

• System power failure restarts 

• Time stamps 

• System startups 

• $SNDERR messages (system service to send 
messages to error log) 

• Operator messages 

• Network messages 

• ERRLOG.SYS created 

Include CPU-related entries in the report. CPU 
entries include the following entry types: 

• SBI alerts/faults 

• Undefined interrupts 

• MBA/UBA adapter errors 

• Asynchronous write errors 

• UBA errors 

Include device errors in the report. 

Include environmental entries in the report. 

Include machine check errors in the report. 
Include memory errors in the report. 

Include snapshot entries in the report. 

Include console-generated entries that describe a 
symptom set used by Digital support personnel 
to identify problems. 

Include device timeout errors in the report. 
Include any entry that had either an unknown 
entry type or an unknown device type or class. 

Include unsolicited MSCP entries in the output 
report. 

Include volume mount and dismount entries in 
the report. 


Description 

You can specify one or more devices by device class, device name, or one or more 
keywords that identify entry types. 

Use the UNKNOWN_ENTRIES keyword to obtain a report that contains the 
contents of the device registers logged by unsupported devices. 

Any known information for the entry is translated; the remaining information is 
output in hexadecimal longwords. 
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Examples 


If you specify a device class keyword or a device name construct with both the 
/INCLUDE and /EXCLUDE qualifiers, the /INCLUDE qualifier takes precedence. 


The BUSES keyword also includes error log entries for the BI bus. The DEVICE 
ERRORS keyword also includes entries for the BI adapter. 


1. $ DIAGNOSE/TRANSLATE/INCLUDE=MTAO 

In this example, the full (default) report consists of entries for the device 
MTAO, which are in the default error log file ERRLOG.SYS. 

2. $ DIAGNOSE/TRANSLATE/INCLUDE=MTAO/EXCLUDE=TAPES 

In this example, the device MTAO is included in the full (default) report for 

the file ERRLOG.SYS. All other magnetic tape devices are excluded from the 
report. 

3. $ DIAGNOSE/TRANSLATE/INCLUDE=(MTAO,VOL) 

In this example, the full (default) report consists of all entries and volume 
mounts and dismounts for the device MTAO, which are in the default error 
log file ERRLOG.SYS. 

4. $ DIAGNOSE/TRANSLATE/INCLUDE=(DISKS,VOLUME_CHANGES) 

In this example, the full (default) report consists of all entries for all disks 
and all entries for volume information, which are in the default error loe file 

TT'DDT nr* ovo & 


5. $ DIAGNOSE/TRANSLATE/INCLUDE=(DISKS,VOLUME_CHANGES,DEVICE_ERROR) 

In this example, the report consists of all entries for disks, all volume entries 
and all device error information on disks, which are in the default error loe 
file ERRLOG.SYS. e 

6. $ DIAGNOSE/TRANSLATE/INCLUDE=(DISKS,VOLUME_CHANGES,DEVICE_ERROR,BUGCHECK) 

In this example, the full (default) report consists of all entries for disks, all 
entries for volume changes, all entries for device error information on disks, 
and all entries for bugcheck events. These entries are in the default error log- 
file ERRLOG.SYS. 


/INTERACTIVE (Alpha Only) 


Allows users to exit the command line interface (CLI) and enter the DECevent 
interactive command shell. 

Format 

/INTERACTIVE 
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Description 

All commands valid from the CLI are valid from within the interactive command 
shell. You do not need to precede qualifiers with DIAGNOSE/TRANSLATE when 
in the interactive command shell. In addition to CLI commands, the interactive 
command shell accepts SET, SAVE, and RESTORE commands. 

Example 

$ DIAGNOSE/TRANSLATE/INTERACTIVE 

In this example, a user has requested to exit the command line interface and 
enter the DECevent interactive command shell. 

The DIAG> prompt is displayed when in the interactive command shell. 


/LOG (Alpha Only) 

Controls whether informational messages that specify the number of entries 
selected and rejected for each input file are sent to SYS$OUTPUT. By default, 
these messages are not displayed. 

Format 

/[NO] LOG 

Example 

$ DIAGNOSE/TRANSLATE/LOG ERRLOG.OLD;5 

In this example, informational messages generated about ERRLOG.OLD;5 are 
sent to SYS$OUTPUT. 


/NODE (Alpha Only) 

Generates a report consisting of error log entries for specific nodes in a 
VMScluster system. 

Format 

/NODE=(node-name[,...]) 

Parameter 

node-name 

Specifies the names of one or more VMScluster members. Names cannot exceed 
six characters. If more than one node name is entered, you must specify a 
comma-separated list of node names that is enclosed in parentheses. 
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Example 

$ DIAGNOSE/TRANSLATE/NODE=(GARCIA,LESH) SYS$SYSROOT:[SYS*.SYSERR]ERRLOG.SYS 

In this example, the VMScluster system consists of members BROOME, GARCIA 
LESH, and PUTNAM. The output full (default) report contains only those entries 
that were logged for nodes GARCIA and LESH. 

/OUTPUT (Alpha Only) 

Specifies the output file for the report. 

Format 

/OUTPUT [=file-spec] 

Parameter 

file-spec 

The output file selected for the report. See the OpenVMS User’s Manual for 
details on specifying files. 

Description 

If you omit the /OUTPUT qualifier, output is directed to SYS$OUTPUT. If you 
specify /OUTPUT=file-spec, the selected output file contains the report. If you 
omit the device or directory specification, the current device and default directory 
are used. If you omit the file name, the file name of the input file is used. If you 
omit the file type, the default file type is .LIS. 

Do not use /OUTPUT with the /BINARY qualifier. 

Example 

$ DIAGNOSE/TRANSLATE/OUTPUT=ERROR_LOG.LIS ERRLOG.OLD;72 

In this example, the default full report ERROR_LOG. LIS contains entries 
generated from ERRLOG.OLD;72. 


/REJECTED (Alpha Only) 

Allows you to specify the name of a file that will contain binary records for 
rejected entries. 

Format 

/REJECTED [=file-spec] 

Parameter 

file-spec 

Specifies the name of the file that is to contain the rejected entries. 
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Description 

The /REJECTED qualifier creates a binary file that contains copies of the original 
binary event log entry. If the event log entry is rejected because the command 
line also specifies an interval (/SINCE, /BEFORE, or /ENTRY qualifier) or a filter 
(/INCLUDE or /EXCLUDE qualifier), the entry is written to the specified file. 

Rejected entries are those entries that are not translated because they fall into 
one of the following categories: 

• All entries specified with the /EXCLUDE qualifier 

• All entries not specified with the /INCLUDE qualifier 

• Any entry that does not occur within the period specified by the /SINCE and 
/BEFORE qualifiers 

• Any entry that is not in the range of entries specified by the /ENTRY qualifier 

If you specify /REJECTED=file-spec, the output file contains image copies of the 
rejected records. If you omit the device or directory specification, the current 
device and default directory are used. If you omit the file name, the file name of 
the input file is used. If you omit the file type, the default file type is .REJ. 

Example 

$ DIAGNOSE/TRANSLATE/INCLUDE/BINARY=MTAO/REJECTED=REAL_ERRS.DAT ERRLOG.OLD;5 

In this example, the output file REAL_ERRS.DAT contains image copies of all 
entries from ERRLOG.OLD;5, with the exception of those entries that apply to 
the MTAO device. Note the use of the /BINARY qualifier. 


/SINCE (Alpha Only) 

Specifies that only those entries dated later than the stated date and time are to 
be selected for the report. 

Format 

/SINCE [=date-time] 

Parameter 

date-time 

Limits the error report to those entries dated later than the specified time. 

Description 

Only absolute date and time specifications are valid. See the OperiVMS User s 
Manual for details on specifying times. 

If you omit the /SINCE qualifier, all entries are processed. If you specify /SINCE 
without a date and time, the default is TODAY. 
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Example 

$ DIAGNOSE/TRANSLATE/SINCE=19-APR-1994:15:00 ERRLOG.OLD;56 

In this example, the full (default) report generated from ERRLOG.OLD;56 
contains entries that have been logged since 15:00 on April 19, 1994. 

/SUMMARY (Alpha Only) 

Generates summary information of all events in the event log. 

Format 

/SUMMARY 


Description 

The /SUMMARY qualifier generates a summary report from the specified input 
event log file. 

Do not use the /BINARY qualifier with /SUMMARY. 


Example 

$ DIAGNOSE/TRANSLATE/SUMMARY ERRLOG.OLD;5 

The output generated by the command in this example is a summary report of all 
entries in ERRLOG.OLD;5. 


/TERSE (Alpha Only) 

Generates a terse report. 

Format 

/TERSE 

Description 

The /TERSE qualifier specifies that the registers and header of each event entry 
be formatted in the standard report type format, but the contents of each register 
are not translated into readable messages. 

Do not use the /TERSE report qualifier with the /BINARY qualifier. 

The Example section shows the format of a typical terse report. 

Example 

$ DIAGNOSE/TRANSLATE/TERSE ERRLOG.OLD;97 

In this example, the terse report generated from ERRLOG.OLD;97 contains 
register and header information. 
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/TRANSLATE (Alpha Only) 

Translates the contents of an event log file. This qualifier is the default qualifier 
to the DIAGNOSE verb. 

Format 

/TRANSLATE [qualifier(s)][infile][,...] 


Description 

The TRANSLATE qualifier translates the contents of the default event log file, 
SYS$ERRORLOG:ERRLOG.SYS, or a selected input event log file. 

Example 

$ DIAGNOSE/TRANSLATE/BRIEF ERRLOG.OLD;97 

In this example, the brief report generated from ERRLOG.OLD;97 contains 
minimal information. 
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DECevent Utility Examples (Alpha Only) 

Sample Event Log Reports 

The DECevent event management utility provides the following five report types: 

• Full 

• Brief 


• Terse 

• Summary 

• FSTERR 

The following sections show examples of each report type with a brief explanation 
of each. 


Full Report Example 

To produce a full report, use the /FULL qualifier. The full report format provides 
a translation of all available information for each entry in the event log. The full 
report is the default report type if a report type is not specified in the command 
line; /TRANSLATE is the default qualifier. 


Both of the following commands will give a full report format: 

$ DIAGNOSE/TRANSLATE/FULL 
$ DIAGNOSE 

Example 9-1 shows the format of a full report. 


Example 9-1 Full Report Format (Alpha Only) 


******************************** ENTRY 


1 ****************************** 


Logging OS 
System Architecture 
OS version 

Event sequence number 
Timestamp of occurrence 
System uptime in seconds 
Error mask 
Flags 
Host name 


1. OpenVMS 

2. Alpha 
V6.2 

1583. 

18-APR-1995 09:21:18 

58004. 

X00000000 

xOOOl Dynamic Device Recognition present 
COGENT 


** 


Alpha HW model 
System type register 
Unique CPU ID 
mpnum 
mperr 


DEC 3000 Model 400 
X00000004 DEC 3000 
X00000002 
X000000FF 
xOOOOOOFF 


Event validity 
Event severity 
Entry type 
Major Event class 

10 Minor Class 
10 Minor Sub Class 


-1. Unknown validity code 
-1. Unknown severity code 
100 . 

3. 10 Subsystem 
1. MSCP 

5. Logged Message 


(continued on next page) 
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Example 9-1 (Cont.) Full Report Format (Alpha Only) 


- Device Profile - 

Vendor 
Product Name 
Unit Name 
Unit Number 
Device Class 


RAID 0 - Host Based 
COGENT$DPA 

10 . 

xOOOl Disk 


- 10 SW Profile - 

VMS DC$_CLASS 1. 

VMS DT$_TYPE 175. 


- MSCP Logged Msg - 


Logged Message Type Code 
RAID Event Type 
Distinguished Member 
Member Index 
RAID Urgency 
RAID Status 


RAIDset Name 


22. RAID Message 
8. Remove Member 
0 . 

1 . 

4. Global Disk Error 
X00180009 Bit 00 - Reduced 
Bit 03 - Striped 
Bit 19 - FE Dis FE 
Bit 20 - BC Buff Copy Off 
KGB 


**************************************************************************** 


Brief Report Example 

To produce a brief report, use the /BRIEF qualifier. The brief report format 
provides translation of key information for each entry in the event log. 

For a brief report format, enter the following command: 

$ DIAGNOSE/TRANSLATE/BRIEF 

Example 9-2 shows the format for a brief report. 


Example 9-2 Brief Report Format (Alpha Only) 


******************************** ENTRY 


1 ******************************** 


Logging OS 

1. OpenVMS 

System Architecture 

2. Alpha 

OS version 

V6.2 

Event sequence number 

1583. 

Timestamp of occurrence 

18-APR-1995 09:21:18 

System uptime in seconds 

58004. 

Error mask 

xOOOOOOOO 

Host name 

COGENT 

Alpha HW model 

DEC 3000 Model 400 

System type register 

X00000004 DEC 3000 

Unique CPU ID 

X00000002 

mpnum 

xOOOOOOFF 

mperr 

X000000FF 

Event validity 

-1. Unknown validity code 

Event severity 

-1. Unknown severity code 

Major Event class 

3. 10 Subsystem 


(continued on next page) 
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Example 9-2 (Cont.) Brief Report Format (Alpha Only) 


10 Minor Class 
10 Minor Sub Class 

- Device Profile - 

Vendor 
Product Name 
Unit Name 
Unit Number 
Device Class 


1. MSCP 

5. Logged Message 


RAID 0 - Host Based 
COGENT$DPA 

10 . 

xOOOl Disk 


Logged Message Type Code 
RAID Event Type 
Distinguished Member 
Member Index 
RAID Urgency 
RAID Status 


RAIDSet Name 


22. RAID Message 
8. Remove Member 
0 . 

1 . 

4. Global Disk Error 

xO0180009 Bit 00 - Reduced 

Bit 03 - Striped 

Bit 19 - FE Dis FE 

Bit 20 - BC Buff Copy Off 
KGB 


*****************************************^^^^^^^^^^^^ 


Terse Report Example 

To produce a terse report, use the /TERSE qualifier. The terse report format 
provides binary event information and displays register values and other ASCII 
messages in a condensed format. 

For a terse report format, enter the following command: 

$ DIAGNOSE/TRANSLATE/TERSE 


Example 9—3 shows the format for a terse report. 


Example 9-3 Terse Report Format (Alpha Only) 


******************************** entry 


1 ******************************** 


Logging OS 
System Architecture 
OS version 

Event sequence number 

Timestamp of occurrence 

System uptime in seconds 

Error mask 

Flags 

Host name 

Alpha HW model 

System type register 

Unique CPU ID 

mpnum 

mperr 

Event validity 
Event severity 
Entry type 
Major Event class 
10 Minor Class 
10 Minor Sub Class 


1 . 

2 . 

V6.2 

1583. 

1995041809211800 

58004. 

X00000000 

xOOOl 

COGENT 

DEC 3000 Model 400 
X00000004 
X00000002 
X000000FF 
X000000FF 
- 1 . 

- 1 . 

100 . 

3. 

1 . 

5. 


(continued on next page) 
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DECevent Utility Examples (Alpha Only) 


Example 9-3 (Cont.) Terse Report Format (Alpha Only) 

- Device Profile - 


Vendor 

Product Name 

RAID 0 - Host 

Unit Name 

COGENT$DPA 

Unit Number 

10. 

Device Class 

xOOOl 

- 10 SW Profile - 

VMS DC$_CLASS 

1 . 

VMS DT$_TYPE 

- MSCP Logged Msg - 

175. 

Logged Message Type Code 

22. 

RAID Event Type 

8. 

Distinguished Member 

0 . 

Member Index 

1 . 

RAID Urgency 

4. 

RAID Status 

X00180009 

RAIDset Name 

KGB 


********************************************************************** 


Summary Report Example 

To produce a summary report, use the /SUMMARY qualifier. The summary report 
format provides a statistical summary of the event entries in the event log. 

For a summary report format, enter the following command: 

$ diagnose/translate/summary 

Example 9-4 shows the format for a summary report. 


Example 9-4 Summary Report Format (Alpha Only) 


*********************************************************************** 


SUMMARY OF ALL ENTRIES LOGGED ON NODE COGENT 


10 Subsystem 
MSCP 

Host Based RAID 

DATE OF EARLIEST ENTRY 
DATE OF LATEST ENTRY 


9. 

3. 

18-APR-1995 09:21:18 
12-MAY-1995 10:44:54 


***************************** 


********************************************** 


FSTERR Report Example 

To produce a FSTERR report, use the /FSTERR qualifier: 

$ DIAGNOSE/TRANSLATE/FSTERR 

The FSTERR report provides a quick, one-line-per-entry report of your event log 
for a variety of disks and tape devices. This makes event analysis and system 
troubleshooting much easier by eliminating extraneous event information. 

The FSTERR report includes only the information that Digital support personnel 
need when troubleshooting a problem with a tape or disk device. 
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DECevent Utility Examples (Alpha Only) 


Example 9-5 shows the format for a FSTERR report. 

Example 9-5 FSTERR Report Format (Alpha Only) 


Drive Name yymmdd hhmmss Entry 

LUKE$DUA070 921119 160754 3 

LUKE$DUA070 921119 160754 4 

HSC015$DUA028 910323 113204 5 

HSC015$DUA028 910323 113204 6 

BATES$DUA197 921118 002116 7 

CHEWIE$DUA101 911205 114908 8 

PMASON$DUA006 921207 165007 15 

PMASON$DUA006 921207 165007 16 

C3P0$DUA242 870218 060031 17 

CHER$DU2132*901008 231053 18 


MSCP 


Physical 

Evnt LED 

LBN 

Cyl Hd Sec RA 

n 

ii 

ii 

ii 

ii 

ii 

n 

ii 

ii 

n 

ii 

ii 

ii 

n 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

00EB 

255 

70 

00EB 

255 

70 

00EB 


70 

00EB 


71 

00EB 


72 

00EB 


73 

00EB 

255 

90 

00EB 

255 

90 

01AB 


90 

00EB 


92 


Drive/ 
HSC Volume 
RP Serial 

71 V00717 
71 V00717 
51 V15039 
51 V15039 
32 V17524 
81 V 17 
42 D23387 
42 D23387 
40 D48575 
81 D 2345 
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Error Log Utility 
















ERROR LOG Description 


The Error Log utility (ERROR LOG) is a system management tool that selectively 
reports the contents of one or more error log files. The operating system 

writes messages to the latest version of an error log file named 
SYS$ERRORLOG:ERRLOG.SYS as the following events occur: 

Errors—Device errors, device timeouts, machine checks, bus errors, memory 
errors (hard or soft error correcting code (ECC) errors), asynchronous write 
errors, undefined interrupts, and bugchecks 

• Volume changes—Volume mounts and dismounts 

• System events Cold startups, warm startups, system failure (crash) 
startups, messages from the Send Message to Error Logger ($SNDERR) 
system 

You can use ERROR LOG with most system-supported hardware, such as 
adapters, disks, tapes, CPUs, and memories, but not with all communications 
devices (for example, the DEQNA). Some synchronous communications devices 
are supported. 
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ERROR LOG Usage Summary 

You can use ERROR LOG to process one or more types of error log entries for 
inclusion in a report. ERROR LOG generates six types of optional formatted 
output: full (default), brief, summary, register dump of device entries, binary copy 
of selected entries, and binary copy of rejected entries. 

The Error Log utility (ERROR LOG) selectively reports the contents of an error 
log file. 

Format 

ANALYZE/ERROFLLOG [/qualifier(s)] [file-spec[,...]] 

Parameters 

The function to be performed by the ANALYZE/ERROR_LOG command. 

filG"Sp6C[j.n] 

Specifies one or more files that contain binary error information to be 
interpreted for the error log report. You can include wildcard characters 
in the file specification. If you omit the file specification, the default file is 
SYS$ERRORLOG:ERRLOG.SYS (see the OpenVMS System Manager s Manual 
for information on maintaining this file). 

See the OpenVMS User’s Manual for details on file specifications. 


Usage Summary 

To invoke ERROR LOG, enter the following DCL command: 


ANALYZE/ERR0R_L0G [/qualifier(s)] [file-spec][,...] 

ERROR LOG does not prompt you. To exit from ERROR LOG, press Ctrl/C. You 
also exit the utility when end-of-file (EOF) is detected. To direct output, use the 
/OUTPUT, /BINARY, and /REJECTED qualifiers with the ANALYZE/ERROR_ 
LOG command. 


You must have SYSPRV privilege to run ERROR LOG; however, only read access 
is required to access the file ERRORLOG.SYS. (It is not necessary to rename the 
file ERRORLOG.SYS to ERRORLOG.OLD before using ERROR LOG.) Do not use 
the /BINARY qualifier with the /FULL, /BRIEF, /OUTPUT, or /REGISTER_DUMP 


qualifiers. 
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ERROR LOG Qualifiers 


The qualifiers for the ANALYZE/ERROR_LOG command 
section. Table 10-1 lists the qualifiers. 


are described in this 


Table 10-1 ERROR LOG Qualifiers 


Qualifier 

Description 

/BEFORE 

Specifies that only those entries dated earlier than the stated 

date and time are to be selected for the error report 

/BINARY 

a whether the binary error log records are converted to 

ASCII text or copied to the specified output file 

/BRIEF 

Generates a brief report 

/ENTRY 

Generates an error log report that includes the specified entry 
range or starts at the specified entry number 

/EXCLUDE 

Excludes errors generated by the specified device class, device 
name, or error log entry type from the error log report 

/FULL 

Generates a full report (default), which provides all available 
information for an error log entry 

/INCLUDE 

Includes errors generated by the specified device class, device 
name, or error log entry type in the error log report 

/LOG 

Controls whether informational messages that specify the 
number of entries selected and rejected for each input file are 
sent to SYS$OUTPUT 

/MODEL 

Generates a report consisting of event log entries for the 
specified CPU (Alpha only) 

/NODE 

Generates a report consisting of error log entries for specific 
nodes in a VMScluster system 

/OUTPUT 

Specifies the output file for the error log report 

/REGISTER_DUMP 

Used in conjunction with the /INCLUDE qualifier to generate, 
in a hexadecimal longword format, a report that consists of 
device register information 

/REJECTED 

Allows you to specify the name of a file that will contain binary 
records for rejected entries 

/SID_REGISTER 

Generates a report consisting of error log entries that occurred 
on the specified CPU (VAX only) 

/SINCE 

Specifies that only those entries dated later than the stated 
date and time are to be selected for the report 

/STATISTICS 

Generates run-time statistical information 

















ERROR LOG 
/BEFORE 


/BEFORE 

Specifies that only those entries dated earlier than the stated date and time are 
to be selected for the error report. 


Format 

/BEFORE [=date-time] 

Parameter 

date-time .„ , ,. Tf 

Limits the error report to those entries dated earlier than the specified time. It 

you do not specify a date or time, all entries are processed. 

Description 

You can specify an absolute time, a delta time, or a combination of absolute and 
delta times. See the OpenVMS User’s Manual for details on specifying times. 

If you omit the /BEFORE qualifier, all entries are processed. 

Example 

$ ANALYZE/ERROR_LOG/BEFORE=19-APR-1994:10:00 ERRLOG.OLD;5 

In this example, the error log report generated for ERRLOG.OLD;5 contains 
entries that were logged before 10:00 A.M. on April 19, 1994. 


/BINARY 

Controls whether the binary error log records are converted to ASCII text or 
copied to the specified output file. 

Format 

/BINARY [=file-spec] 

/NOBINARY 

Parameter 

file-spec . . , 

Specifies the output file selected to contain image copies of the input records. 


Description 

The /BINARY qualifier creates a binary file that contains copies of the original 
binary error log entry if the command line also specifies an interval (/SINCE, 
/BEFORE, or /ENTRY qualifier) or a filter (/INCLUDE or /EXCLUDE qualifier). 
If no interval or filter is specified, all error log entries are copied. 
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ERROR LOG 
/BINARY 


If you specify /BINARY-file-spec, the selected output file contains image copies of 
the binary input records (the records are not translated to ASCII). If you omit the 
device or directory specification, the current device and the default directory are 
used. If you omit the file name, the file name of the input file is used. If you omit 
the file type, the default file type is .DAT. 

Do not use /BINARY with the /FULL, /BRIEF, /OUTPUT, or /REGISTER_DUMP 
qualifiers. These qualifiers generate an ASCII report; /BINARY generates a 
binary file. 

Example 

$ ANALYZE/ERROR_LOG/INCLUDE=DBA1/BINARY=DBA1_ERR.DAT 
ERRLOG.OLD;5 

In this example, the output file DBA1_ERR.DAT contains image copies of the 
entries that apply to DBA1. 


/BRIEF 


Generates a brief report. 

Format 

/BRIEF 

Description 

Do not use /BRIEF with the /BINARY qualifier. 

The Example section shows the format of a typical brief error log report. 

Example 


$ ANALYZE/ERROR_LOG/BRIEF ERRLOG.OLD;97 

In this example, the error log report generated from ERRLOG.OLD;97 contains 
minimal information. 

/ENTRY 

Generates an error log report that includes the specified entry range or starts at 
the specified entry number. 

Format 


/ENTRY [=(START:decimal-value[,END:decimal-value])] 

Parameter 

(START:decimal-value[,END:decimal-value]) 

Specifies the range of entries to be included in the error log report. 
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ERROR LOG 
/ENTRY 


Description 


If you specify /ENTRY without the entry range or omit the qualifier, the entry 
range defaults to START:l,END:end-of-file. 


Example 


$ ANALYZE/ERR0R_L0G/ENTRY=(START:1,END:18) ERRLOG.SYS 

In this example, the entry range for the error log report generated from file 
ERRLOG.SYS is limited to entry numbers 1 to 18. 


/EXCLUDE 


Excludes errors generated by the specified device class, device name, or error log 
entry type from the error log report. 


Format 



Parameters 


device-class 

device-name 

entry-type 

Specifies one or more keywords denoting the device class, device name, or 
error log entry type. If you specify more than one keyword, you must specify a 
comma-separated list of values that is enclosed in parentheses. 

Device Class Keywords 

ADAPTER 

BUSES 

CACHE 

DISKS 

INFORMATIONAL 

LINE.PRINTER 

REALTIME 

SYNC_COMMUNICATIONS 

TAPES 

VECTOR 

WORKSTATION 

Examples of Device Name Constructs 

DB Group of devices 

DBAl Specific device/unit number 

(DBA1,HSC1$DUA1,DYA0) List of devices 

(DB,DR,XF) List of device groups 
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ERROR LOG 
/EXCLUDE 


Entry-Type Keywords 

ATTENTIONS 

BUGCHECKS 

CONFIGURATION 

CONTROL.ENTRIES 


CPU_ENTRIES 


DEVICE.ERRORS 

ENVIRONMENTAL^ 

ENTRIES 

MACHINE_CHECKS 

MEMORY 

SNAPSHOT_ENTRIES 

SYNDROME 


TIMEOUTS 

UNKNOWN_ENTRIES 

UNSOLICITED.MSCP 

VOLUME_CHANGES 


Exclude device attention entries from the report. 

Exclude all types of bugcheck entries from the 
report. 

Exclude system configuration entries from the 
report. 

Exclude control entries from the report. Control 
entries include the following entry types: 

• System power failure restarts 

• Time stamps 

• System startups 

• $SNDERR messages (system service to send 
messages to error log) 

• Operator messages 

• Network messages 

• ERRLOG.SYS created 

Exclude CPU-related entries from the report. 
CPU entries include the following entry types: 

• SBI alerts/faults 

• Undefined interrupts 

• MBA/UBA adapter errors 

• Asynchronous write errors 

• UBA errors 

Exclude device error entries from the report. 
Exclude environmental entries from the report. 

Exclude machine check entries from the report. 
Exclude memory errors from the report. 

Exclude snapshot entries from the report. 

Exclude console-generated entries that describe a 
symptom set used by Digital Services personnel 
to identify problems. 

Exclude device timeout entries from the report. 

Exclude any entry that had either an unknown 
entry type or an unknown device type or class. 

Exclude unsolicited MSCP entries from the 
output report. 

Exclude volume mount and dismount entries 
from the report. 
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ERROR LOG 
/EXCLUDE 


Description 

You can specify one or more devices by device class, device name, or one or more 
keywords that identify entry types. 

Unless you specify the UNKNOWN.ENTRIES keyword to explicitly exclude from 
a report any entries from unsupported (unknown) devices, any unknown device is 
reported. 

Any known information for the entry is translated; the remaining information is 
output in hexadecimal longwords. 

If you specify a device class keyword or a device name construct with both the 
/INCLUDE and /EXCLUDE qualifiers, the /INCLUDE qualifier takes precedence. 

The BUSES keyword also excludes error log entries for the BI bus. The DEVICE. 
ERRORS keyword also excludes entries for the BI adapter. 


Examples 

1. $ ANALYZE / ERROR.LOG/EXCLUDE=MTAO 

In this example, the error log entries for the device MTAO are excluded from 
the error log report for the file ERRLOG.SYS. 

2. $ ANALYZE/ERROR_LOG/EXCLUDE=(MTAO,DRA5) ERRLOG.OLD 

In this example, the devices MTAO and DRA5 are excluded from the error log 
report for the file ERRLOG.OLD. 

3. $ ANALYZE/ERROR.LOG/EXCLUDE=(DISKS,BUGCHECKS) 

In this example, all disk devices and all bugcheck entries are excluded from 
the error log report for the file ERRLOG.SYS. 

4. $ ANALYZE/ERROR_LOG/EXCLUDE=TAPES/INCLUDE=MTAO 

In this example, the device MTAO is included in the error log report for the 
file ERRLOG.SYS. All other magnetic tape devices are excluded from the 
report. 

5. $ ANALYZE/ERROR.LOG/EXCLUDE=(DISK,VOLUME.CHANGES) 

In this example, entries for disk volume information are excluded from the 
error log report for the file ERRLOG.SYS. 

6. $ ANALYZE/ERROR.LOG/EXCLUDE=(DISK,VOLUME.CHANGES,DEVICE.ERROR) 

In this example, entries for volume and device error information on disks are 
excluded from the error log report for the file ERRLOG.SYS. 

7. $ ANALYZE/ERROR_LOG/EXCLUDE=(DISK,VOLUME_CHANGES,DEVICE_ERROR,BUGCHECK) 

In this example, entries for volume and device error information on disks, 
and bugcheck errors are excluded from the error log report for the file 
ERRLOG.SYS. 
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ERROR LOG 
/FULL 


/FULL 


Cerates a full report, which provides all available information for an error log 
entry. This is the default report format. 

Format 

/[NOJFULL 

Description 

Do not use /FULL with the /BINARY qualifier. 

Examples 

1. $ ANALYZE/ERR0R_L0G/FULL ERRLOG.OLD;72 

The command in this example produces a full report. 

2. $ ANALYZE/ERROR_LOG ERRLOG.OLD;72 

The command in this example produces a full report. The default report type 
is /FULL; it is not necessary to specify it in the command line. 


/INCLUDE 


Includes errors generated by the specified device class, device name, or error log 
entry type in the error log report. 

Format 

{ device-class ] 
device-name 1 [,...]) 
entry-type j 

Parameters 

device-class 

device-name 

entry-type 

Specifies one or more keywords denoting the device class, device name, or entry 
type. If you specify more than one keyword, you must specify a comma-separated 
list of values that is enclosed in parentheses. 

Device Class Keywords 

ADAPTER 

BUSES 

CACHE 

DISKS 

INFORMATIONAL 

LINE_PRINTER 

REALTIME 

SYNC.COMMUNICATIONS 
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ERROR LOG 
/INCLUDE 


TAPES 

VECTOR 

WORKSTATION 

Examples of Device Name Constructs 

Group of devices 
Specific device/unit number 
(DBA1,HSC1$DUA1,DYA0) List of devices 

(DB,DR,XF) List of device groups 


Entry-Type Keywords 

ATTENTIONS 

BUGCHECKS 

CONFIGURATION 

CONTROL.ENTRIES 


Include device attention entries in the report. 
Include all types of bugcheck errors in the report. 
Include system configuration entries in the 
report. 

Include control entries in the report. Control 
entries include the following entry types: 


• System power failure restarts 

• Time stamps 

• System startups 

• $SNDERR messages (system service to send 
messages to error log) 

• Operator messages 

• Network messages 

• ERRLOG.SYS created 


CPU.ENTRIES 


DEVICE.ERRORS 

ENVIRONMENTAL. 

ENTRIES 

MACHINE.CHECKS 

MEMORY 

SNAPSHOT.ENTRIES 

SYNDROME 


TIMEOUTS 


Include CPU-related entries in the report. CPU 
entries include the following entry types: 

• SBI alerts/faults 

• Undefined interrupts 

• MBA/UBA adapter errors 

• Asynchronous write errors 

• UBA errors 

Include device errors in the report. 

Include environmental entries in the report. 

Include machine check errors in the report. 
Include memory errors in the report. 

Include snapshot entries in the report. 

Include console-generated entries that describe a 
symptom set used by Digital Services personnel 
to identify problems. 

Include device timeout errors in the report. 
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ERROR LOG 
/INCLUDE 


UNKNOWN.ENTRIES 

UNSOLICITED.MSCP 

VOLUME.CHANGES 


Include any entry that had either an unknown 
entry type or an unknown device type or class. 

Include unsolicited MSCP entries in the output 
report. 

Include volume mount and dismount entries in 
the report. 


Description 

You can specify one or more devices by device class, device name, or one or more 
keywords that identify entry types. 

Use the UNKNOWN_ENTRIES keyword to obtain a report that contains the 
contents of the device registers logged by unsupported devices. 

Any known information for the entry is translated; the remaining information is 
output in hexadecimal longwords. 


Examples 


1™?!^ 3 device class keyword or a device name construct with both the 
/INCLUDE and /EXCLUDE qualifiers, the /INCLUDE qualifier takes precedence. 

The BUSES keyword also includes error log entries for the BI bus. The DEVICE, 
ERRORS keyword also includes entries for the BI adapter. 


1. $ ANALYZE/ERROR_LOG/INCLUDE=MTAO 

In this example, the report consists of error log entries for the device MTAO 
which are in the default error log file ERRLOG.SYS. 


2 . 


3. 


$ analyze/error_log/include=mtao/exclude=tapes 

In this example, the device MTAO is included in the error log report for the 

file ERRLOG.SYS. All other magnetic tape devices are excluded from the 
report. 

$ ANALYZE/ERROR_LOG/INCLUDE=(MTAO,VOL) 


In this example, the report consists of error log entries and volume mounts 
and dismounts for the device MTAO, which are in the default error log file 


4. $ ANALYZE/ERROR_LOG/INCLUDE=(DISK,VOLUME_CHANGES) 

In this example, the report consists of error log entries for disk volume 
information, which are in the default error log file ERRLOG.SYS. 

5. $ ANALYZE/ERROR_LOG/INCLUDE=(DISK,VOLUME_CHANGES,DEVICE_ERROR) 

In this example, the report consists of error log entries for volume and 
device error information on disks, which are in the default error log file 

i?ddt nr* cvo ® 


6. $ ANALYZE/ERROR_LOG/INCLUDE=(DISK,VOLUME_CHANGES,DEVICE_ERROR,BUGCHECK) 

In this example, the report consists of error log entries for volume and device 
error information on disks, and bugcheck errors. These entries are in the 
default error log file ERRLOG.SYS. 
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ERROR LOG 
/LOG 


/LOG 


Controls whether informational messages that specify the number of entries 
selected and rejected for each input file are sent to SYS$OUTPUT. By default, 
these messages are not displayed. 


Format 

/[NO]LOG 

Example 

$ ANALYZE/ERROR_LOG/LOG ERRLOG.OLD;5 

In this example, informational messages generated about ERRLOG.OLD,5 are 
sent to SYS$OUTPUT. 


/MODEL (Alpha Only) 


Alpha 


On Alpha systems, generates a report consisting of event log entries that occurred 
on the specified CPU. 


Format 

/MODEL=(hexadecimal-value[,...]) 

Parameter 

hexadecimal-value 

Specifies a value obtained from the system console. 

In a VMScluster environment, you can specify a hexadecimal value for each 
member. If you specify more than one hexadecimal value, you must specify a 
comma-separated list of values that is enclosed in parentheses. 

Example 

$ ANALYZE/ERROR_LOG/MODEL=415 ERRLOG.SYS 

In this example, the output consists of only those entries that were logged for the 
system with a model type of 00000415 (hexadecimal). ♦ 


/NODE 

Generates a report consisting of error log entries for specific nodes in a 
VMScluster system. 

Format 

/NODE=(node-name[,...]) 
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ERROR LOG 
/NODE 


Parameter 

node-name 

Specifies the names of one or more VMScluster members. Names cannot exceed 
six characters. If more than one node name is entered, you must specify a 
comma-separated list of node names that is enclosed in parentheses. 

Example 


$ ANALYZE/ERROR_LOG/NODE=(ORANGE,NASSAU) 
SYS$SYSR00T:[SYS*.SYSERR]ERRLOG.SYS 


In this example, the VMScluster system consists of members BROOME 
NASSAU, ORANGE, and PUTNAM. The output contains only those entries 
that were logged for nodes NASSAU and ORANGE. 


/OUTPUT 

Specifies the output file for the error log report. 

Format 

/OUTPUT [=file-spec] 

Parameter 

file-spec 

Specifies the output file selected for the error log report. See the OpenVMS User’s 
Manual for details on specifying files. If you omit the output file specification 
output is directed to SYS$OUTPUT. 

Description 

If you omit the /OUTPUT qualifier, output is directed to SYS$OUTPUT. If you 
specify /OUTPUT=file-spec, the selected output file contains the error log report 
It you omit the device or directory specification, the current device and default 
directory are used. If you omit the file name, the file name of the input file is 
used. If you omit the file type, the default file type is .LIS. 

Do not use /OUTPUT with the /BINARY qualifier. 

Example 

$ ANALYZE/ERRORJX>G/OUTPUT=ERROR_LOG.LIS ERRLOG.OLD;72 

° Uput file ERR0R - L0G -LIS contains entries generated from 

Ji<KKijU(jr. OLD; 72. 
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ERROR LOG 
/REGISTER_DUMP 


/REGISTER_DUMP 

Used in conjunction with the /INCLUDE qualifier to generate, in a hexadecimal 
longword format, a report that consists of device register information. 

Format 

/REGISTEFLDUMP 


Description 


Use the /REGISTER.DUMP qualifier to get a report that lists the hexadecimal 
contents of the device registers for the device specified by the /INCLUDE qualifier. 
The /INCLUDE qualifier must be used with the /REGISTER_DUMP qualifier. 


The /REGISTER_DUMP qualifier reports register contents for memory, device 
error, and device timeout entries. No translation is available of any of the device 
register information. 


Do not use /REGISTER_DUMP with the /BINARY qualifier. 


Example 

$ ANALYZE/ERR0R_L0G/INCLUDE=DB/REGISTER_DUMP ERRLOG.OLD;72 

In this example, the output is in the format of a REGISTER.DUMP report 
containing entries that apply only to the DB device. 


/REJECTED 

Allows you to specify the name of a file that will contain binary records for 
rejected entries. 

Format 

/REJECTED [=file-spec] 

Parameter 

file-spec , T „ , . 

Specifies the name of the file that is to contain the rejected entries^ If you do not 

specify an output file, the rejected entries are written to the file ERRLOG.REJ in 
your current directory. 

Description 

The /REJECTED qualifier creates a binary file that contains copies of the original 
binary error log entry. If the error log entry is rejected because the command 
line also specifies an interval (/SINCE, /BEFORE, or /ENTRY qualifier) or a filter 
(/INCLUDE or /EXCLUDE qualifier), the entry is written to the specified file. 

Rejected entries are those entries that are not translated because they fall into 
one of the following categories: 

• All entries specified with the /EXCLUDE qualifier 

• All entries not specified with the /INCLUDE qualifier 
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ERROR LOG 
/REJECTED 


Example 


tha * f oes not occur within th e period specified by the /SINCE and 
/Bhjb ORE qualifiers 

Any entry that is not in the range of entries specified by the /ENTRY qualifier 

If you specify/REJECTED=file-spec, the output file contains image copies of the 
rejected records If you omit the device or directory specification, the current 
device and default directory are used. If you omit the file name, the file name of 
the input file is used. If you omit the file type, the default file type is REJ 


$ ANALYZE/ERROR_LOG/INCLUDE=MTAO/REJECTED=REAL_ERRS.DAT ERRLOG.OLD;5 

In this example the output file REAL_ERRS.DAT contains image copies of all 

f^MTAn!? ERRLOG.OLD;5, with the exception of those entries that apply to 
the M1 AO device. 


/SID.REGISTER (VAX Only) 

® On VAX systems generates a report consisting of error log entries that occurred 
on the specified CPU. 

Format 

/SID_REGISTER=(hexadecimal-value[,...]) 

Parameter 


hexadecimal-value 

Specifies a value obtained from the system ID register. Use the $GETSYI system 
service to obtain this value, which is unique to each system. The OpenVMS 
System Services Reference Manual describes the $GETSYI system service. 

In a VMScluster environment, you can specify a hexadecimal value for each 
member. If you specify more than one hexadecimal value, you must specify a 
comma-separated list of values that is enclosed in parentheses. 


Example 


$ ANALYZE/ERR0R_L0G/SID_REGISTER= 02006148 ERRLOG.OLD;72 


In this example, the output consists of only those entries that 
system with an ID of 02006148 (hexadecimal). ♦ 


were logged for the 


/SINCE 


Specifies that only those entries dated later than the stated date and 
be selected for the report. 


time are to 
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ERROR LOG 
/SINCE 


Format 


/SINCE [=date-time] 


Parameter 


LhnitsThe error report to those entries dated later than the specified time. If you 
specify /SINCE without a date and time, the default is TODAY. If you omit the 
/SINCE qualifier, all entries are processed. 


Description 

Only absolute date and time specifications are valid. See the OpenVMS Users 
Manual for details on specifying times. 


Example 

$ ANALYZE/ERROR_LOG/SINCE=19-APR-1994:15:00 ERRLOG.OLD;56 

In this example, the error log report generated from ERRLOG.OLD;56 contains 
entries that have been logged since 15:00 on April 19, 1994. 


/STATISTICS 

Generates run-time statistical information. 


Format 

/STATISTICS 

Description 

Use the /STATISTICS qualifier to generate a report that consists of the page 
faults, buffered I/O, direct I/O, and CPU time used in the execution of the 
ANALYZE/ERROR_LOG command. 

Example 

$ ANALYZE/ERR0R_L0G/STATISTICS ERRLOG.OLD;4 

In this example, the output generated by this command consists of a full report of 
all entries in ERRLOG.OLD;4 and the run-time statistics for the execution of the 

command. 
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ERROR LOG Examples 


Sample Error Log Report 

An error log report entry contains two sections: identification and device- 
dependent data. The identification section consists of the first four lines and 
is generated for all reports. The device-dependent data section, which follows 
identification section, contains information on the selected error log entries. 


the 


The first line of the identification section gives the error entry number. This 
number can be used to refer to a particular error log entry in an error log file 
Ihe second line contains the error sequence number and the system identification 
value. The error sequence number is a value assigned by the operating system 
o an error log entry to help determine if error log entries are being lost. This 
sequence number value is reset to zero only when the system is rebooted. The 
third and fourth lines of this section specify the type of error log entry being 
reported the date and time the entry was made, the processor type and revision 
level, and the system serial number. 


The first line of the device-dependent data section identifies the device or 
subsystem on which the error occurred. The remainder of this section consists 
of hardware information, which shows the contents of the device registers and 

software information, which shows the contents of the I/O database at the time of 
the error. 


The OpenVMS System Manager’s Manual contains additional information on 
error log reports, including descriptions of error log entries. These descriptions 
specify the action recommended for specific entries. 

The following output report is an example of the report generated by device 
errors, device attention, and device timeouts from a disk on the system. 


VMS 

15:49:10 


SYSTEM ERROR REPORT COMPILED 3-SEP-1994 


26. 

******************************* ENTRy 
******************************* 


904. 


PAGE 


ERROR SEQUENCE 709. 

DATE/TIME 20-AUG-1994 15:21:10.79 
00000003 

SYSTEM UPTIME: 1 DAYS 01:35:47 
SCS NODE: LSR3 


DEVICE ERROR SYS_TYPE 

= 03 

RZ57 SUB-SYSTEM, UNIT 

_LSR3$DKA0 

HW REVISION 

30303035 

ERROR TYPE 

03 

SCSI ID 

00 

SCSI LUN 

00 

SCSI SUBLUN 

00 

PORT STATUS 

00000054 


LOGGED ON: CPU_TYPE 00000002 
SYS_TYPE 

VMS T1.0-FT3 

HW REVISION = 5000 
COMMAND TRANSMISSION FAILURE 
SCSI ID = 0. 

SCSI LUN = 0. 

SCSI SUBLUN = 0. 

%SYSTEM-F-CTRLERR, FATAL CONTROLLER 
ERROR 
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27. 


SCSI CMD 

00000000 



0000 

TEST UNIT RDY 

SCSI STATUS 

FF 

NO STATUS RECEIVED 

UCB$B_ERTCNT 

OF 

15. RETRIES REMAINING 

UCB$B_ERTMAX 

00 

0. RETRIES ALLOWABLE 

0RB$L_0WNER 

00000000 

OWNER UIC [000,000] 

UCB$L_CHAR 

1CC54008 

DIRECTORY STRUCTURED 

FILE ORIENTED 

SHARABLE 

AVAILABLE 

ERROR LOGGING 

ALLOCATED 

CAPABLE OF INPUT 

CAPABLE OF OUTPUT 

RANDOM ACCESS 

UCB$L_STS 

56544552 

INTERRUPT EXPECTED 

ONLINE 

TIMED OUT 



BUSY 

DEALLOCATE AT DISMOUNT 

"MOUNT VERIFICATION" IN-PROGRESS 

UCB$L_0PCNT 

00000000 

0. QIO'S THIS UNIT 

UCB$W_ERRCNT 

0001 

1. ERRORS THIS UNIT 

S 

SYSTEM ERROR REPORT COMPILED 3-SEP-1994 

i;10 


PAGE 

IRP$L_BCNT 

00000000 

TRANSFER SIZE 0. BYTE(S) 

IRP$L_B0FF 

00000000 

TRANSFER PAGE ALIGNED 

IRP$L_PID 

00010042 

REQUESTOR "PID" 

IRP$Q_I0SB 

0000014E 

430A0002 

IOSB, 0. BYTE(S) TRANSFERRED 


Time Stamp, Volume Mount, and Volume Dismount Entries Examples 

The following are entry examples of a system time stamp, volume mount, and 
volume dismount. The time-stamp entry contains only an identification section, 
which is logged by the operating system at 10-minute intervals. If no other error 
log entries are made during the 10-minute period, the previous time stamp is 
overwritten with the current time stamp. 

The mount volume entry contains an identification section followed by a device¬ 
dependent data section. The device-dependent data section shows the name of 
the device the volume is mounted on, the volume label (if the volume has a label), 
and the I/O operations and error counts for the device. 

The dismount volume entry contains, in addition to the data provided in the 
volume mount entry, the I/O operations and error counts for the device on which 
the volume was mounted. 
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**************************** ENTRY 
ERROR SEQUENCE 421. 

TIME STAMP, 4-MAR-94 11:10:08.79 

KA780 REV# 7. SERIAL# 7. 

**************************** ENTRy 
ERROR SEQUENCE 422. 

MOUNT VOLUME, 4-MAR-94 11:14:12.51 

KA780 REV# 7. SERIAL# 7 

UNIT _DMA0:, VOLUME LABEL "TEST 


93, **************************** 
LOGGED ON SID 01380101 


94. **************************** 

LOGGED ON SID 01380101 


656. QIO OPERATIONS THIS UNIT, 
**************************** 

ERROR SEQUENCE 423. 


ERRORS THIS UNIT 
95. **************************** 
LOGGED ON SID 01380101 


DISMOUNT VOLUME, 4-MAR-94 11:14:41.30 

KA780 REV# 7. SERIAL# 7. 


UNIT _DMA0:, VOLUME LABEL "TEST" 


697. QIO OPERATIONS THIS UNIT, 1. ERRORS THIS UNIT 
41. QIO OPERATIONS THIS VOLUME, 0. ERRORS THIS VOLUME 

Machine Check Entries Examples 

The following are examples of machine check error reports. Each report consists 
of three sections: the identification section, the program counter and summary 
code section, and an error-dependent section. 

The program counter and summary code section of the report displays the 
contents of the program counter, the processor status longword, and the summary 
code. The contents of the processor status longword and the summaiy code are 
described in the text on the right side of the report. 

The error-dependent section consists of CPU-dependent information that was 
logged as a result of the machine check. 


******************************* ENTRy 
******************************* 

ERROR SEQUENCE 2. 

DATE/TIME 4-SEP-1994 09:39:51 19 
00000002 

SYSTEM UPTIME: 90 DAYS 00:01:25 


SCS NODE: COBRA6 

MACHINE CHECK SYS_TYPE = 02 

KERNEL EVENT HEADER 

FRAME REVISION 0000 

SCB VECTOR 0670 

1ST MOST PRB FRU 00 

2ND MOST PRB FRU 00 

SEVERITY 0000 

CPU ID 0000 

ERROR COUNT 0001 

THRESHOLD 0000 

FAIL CODE 0000 


ERR FIELD LOW 00000005 
00000008 


2 . 

LOGGED ON: CPU_TYPE 00000002 
SYS_TYPE 

VMS X5DN-FT4 

FIELD NOT VALID 
FIELD NOT VALID 
FIELD NOT VALID 


CPU_0 BUS COMMAND NO-ACK 

CPU_0 BUS READ PARITY ERROR 

CPU CYCLE ABORTED WITH HARD ERROR 
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ERR FIELD HIGH 

00000000 

RETRY/BYTE CNT 

00000000 

00000250 

00000000 

BYTE COUNT = 00000250(X) 

CAN'T RETRY 

PALTEMPO 

00000001 

00000000 

PALTEMP1 

000000BE 

00000000 

PALTEMP2 

00000004 

001FC0F8 

PALTEMP3 

00000000 

00000000 

PALTEMP4 

805C3FC0 

FFFFFFFF 

PALTEMP5 

00000000 

00000000 

PALTEMP6 

84FDEOOO 

FFFFFFFF 

PALTEMP7 

00004200 

00000000 

PALTEMP8 

00000400 

00000000 

PALTEMP9 

00000003 

00000000 

PALTEMP10 

29CB0233 

00000003 

PALTEMP11 

00000000 

00000000 

PALTEMP12 

VMS 

10:37:03 

00000001 

SYSTEM ERROR REPORT COMPILED 8-SEP 1994 

PAGE 

2. 


PALTEMP13 

00000000 

8042F4CO 

FFFFFFFF 

PALTEMP14 

00000000 

00000000 

PALTEMP15 

00000000 

00000000 

PALTEMP16 

oooocooo 

00000000 

PALTEMP17 

00000000 

00000000 

PALTEMP18 

BEBC2000 

00000000 

PALTEMP19 

7FFBF924 

00000000 

PALTEMP2 0 

00002041 

00000000 

PALTEMP21 

40000000 

00000002 

PALTEMP22 

00000000 

00000000 

PALTEMP23 

00000000 

00000000 

PALTEMP24 

805C0000 

FFFFFFFF 

PALTEMP25 

00000000 

00000000 

PALTEMP26 

7FF96000 

00000000 
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PALTEMP27 

00000000 

00000000 

PALTEMP2 8 

00D7C000 

00000000 

PALTEMP29 

00000000 

00000002 

PALTEMP3 0 

002F6000 

00000000 

PALTEMP31 

00D62080 

00000000 

EXCP ADDR REG 

0000815E 

00000000 

EXCP SUM REG 

00000000 

00000000 

EXCP MASK REG 

00000000 

00000000 

ICCS REG 

00000004 

001FC0F8 

PAL BASE 

00008000 

00000000 

HW INTR EN REG 

FFFFDCF0 

00000001 


SYSTEM ERROR 


10:37:03 


Not PALmode instruction 
EXCEPTION PC = 0000000000002057(X) 


PAL BASE PA = 000008000(X) 


CRD ERROR INT. ENABLE 
HARDWARE INT. ENABLED ON PIN 3 
REPORT COMPILED 8-SEP-1994 

PAGE 


HARDWARE INT. ENABLED ON PIN 4 
HARDWARE INT. ENABLED ON PIN 5 
PCI INT. DISABLED 
PC0 INT. DISABLED 
HARDWARE INT. ENABLED ON PIN 0 
HARDWARE INT. ENABLED ON PIN 1 
HARDWARE INT. ENABLED ON PIN 2 
SLU INT. DISABLE 
SOFTWARE INT. LEVEL 1 ENABLED 
SOFTWARE INT. LEVEL 2 ENABLED 
SOFTWARE INT. LEVEL 3 ENABLED 
SOFTWARE INT. LEVEL 4 ENABLED 
SOFTWARE INT. LEVEL 5 ENABLED 
SOFTWARE INT. LEVEL 6 ENABLED 
SOFTWARE INT. LEVEL 7 ENABLED 
SOFTWARE INT. LEVEL 8 ENABLED 
SOFTWARE INT. LEVEL 9 ENABLED 
SOFTWARE INT. LEVEL 10 ENABLED 
SOFTWARE INT. LEVEL 11 ENABLED 
SOFTWARE INT. LEVEL 12 ENABLED 
SOFTWARE INT. LEVEL 13 ENABLED 
SOFTWARE INT. LEVEL 14 ENABLED 
SOFTWARE INT. LEVEL 15 ENABLED 
KERNAL MODE AST INT. ENABLED 
EXEC. MODE AST INT. ENABLED 
SUPER. MODE AST INT. ENABLED 
USER MODE AST INT. ENABLED 
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HW INTR REQ REG 00000702 
00000000 

HW INTR. REQ 
PCI INTR REQ. 

PCO INTR REQ. 

CPU INTR REQ. on pin 0 

MEM MGMT ER/DTB 00005110 

00000000 ,, , 4 
Integer Reg. used is R = 11(X) 
OP code = 28(X) 

D-CACHE STA REG 000002E0 
00000000 

D-CACHE ADD REG FFFFFFFF 
00000007 

ABOX CTL REG 0000040E 
00000000 

MCHECK ENABLED for UNCOR. ERR 
CRD INTR. ENABLE 
ICACHE STREAM BUFFER ENABLED 
DCACHE ENABLED 


BIU STATUS REG 00002041 
00000000 

Hard Error 
Dcache fill error 
READ_BLOCK 

BIU ADD REG 40000000 

00000002 

BIU CTL REG 30006337 

OOOOOOOC 

V M S SYSTEM ERROR REPORT COMPILED 

10:37:03 


8-SEP-1994 


PAGE 


4. 


External Cache Enable 
ECC Checking 

Output Enable of Cache RAMs 
BCache Read Speed in cycles = 4(X) 
BCache Write Speed in cycles = 4(X) 

ECC SYNDROMES 00000000 
00000000 

FILL ADDR REG 00006120 
00000000 

MACHINE CHK VA 00006190 
00000000 

B-CACHE TAG REG 12491412 
14480005 

TAG Control P 
TAG Control V 
B-Cache TAG = 48A0(X) 

400001C1 
400001C1 
400001C1 
00000000 
00000000 
00000000 
00000000 
00000900 
00000900 
00D40A2D 
00D40A2D 


CSR0 

BCC 

CSR1 

BCCE 

CSR2 

BCCEA 

CSR3 

BCUE 

CSR4 

BCUEA 
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CSR5 

0011D4B4 


DTER 

0011D4B4 


CSR6 

00007F28 


CBCTL 

00007F28 

98004082 


CSR7 

98004082 


CBE 

9C001042 


CSR8 

90000003 


CBEAL 

90000003 


CSR9 

FF200083 


CBEAH 

FF200083 


CSR10 

00000000 


PMBX 

00000000 


CSR11 

00000000 


IPIR 

00000000 


CSR12 

00000004 


SIC 

00000001 


CSR13 

000C1388 


ADLK 

000C1388 


CSR14 

00104B7B 


MADRL 

00104B6B 


VMS 

10:37:04 

SYSTEM ERROR REPORT COMPILED 8-SEP-1994 

******************** 

******** Flippy 

6. **************************** 

ERROR SEQUENCE 3. 


LOGGED ON SID 03003700 

MACHINE CHECK, 6-MAR-1994 10:11:34.70 

KA730 REV# 0. MIC# 

55. 

EXCEPTION PC 

80038DCO 


ERROR PSL 

01C00000 

INTERRUPT PRIORITY LEVEL =00. 
PREVIOUS MODE = USER 

CURRENT MODE = EXECUTIVE 

SUMMARY CODE 

1ST PARAMETER 

00000007 

UNCORRECTABLE ECC ERROR 

00166200 



PAGE #2865. IN ERROR 

**************************** ENTRy 

60. **************************** 

ERROR SEQUENCE 4872. 


LOGGED ON SID 02006148 

MACHINE CHECK, 6-MAR- 

•1994 03:50:08. 

28 

KA750 

REV# 72. MIC# 

97. 

EXCEPTION PC 

80006173 


ERROR PSL 

00C80009 

C-BIT 

N-BIT 

INTERRUPT PRIORITY LEVEL =08. 
PREVIOUS MODE = USER 

CURRENT MODE = KERNEL 
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SUMMARY CODE 00000002 

VA LAST REF 800A079E 
PC AT ERROR 80006178 
MDR 8009F38C 
SMR 00000008 


RLTO 00000000 

TBER 00000007 


CAER 00000000 
BER 00000000 
MCESR 00000004 


**************************** ENTRY 
ERROR SEQUENCE 4949. 


TRANSLATION BUFFER OR BUS ERROR 


CPU MODE = KERNEL 

VIRTUAL 

READ 


TB GO DATA ERROR 
TB G1 DATA ERROR 
TB GO TAG ERROR 


OPERAND REFERENCE 

TB PARITY ERROR 

**************************** 

LOGGED ON SID 01388525 


MACHINE CHECK, 6-MAR-1994 15:09:11.31 

KA780 REV# 7. SERIAL# 1317. 


EXCEPTION PC 00004890 
ERROR PSL 03COOOOO 

SUMMARY CODE 00000000 

CES 00010084 

MICRO PC 00000200 

VA/VIBA 7FF735D4 

D REGISTER FFFFC284 

TBER0 0000DC81 

TBER1 00000040 

SBITA E00B83F5 

CACHE PE REG 00004000 
SBIER 00001802 


INTERRUPT PRIORITY LEVEL = 00. 
PREVIOUS MODE = USER 
CURRENT MODE = USER 


CP READ TIMEOUT 
- OR ERROR CONFIRMATION FAULT 

SUPERVISOR AST PENDING 
ALU C31 
NESTED ERROR 


ENABLE MEMORY MANAGEMENT 
TB HIT GROUP 1 
MICRO CODE "MCT" FIELD = 07 
MICRO CODE “ADS" 

MICRO CODE "FS" 

LAST TB WRITE PULSE TO GROUP 1 

TIMEOUT CONSOLE ADDR = 002E0FD4 
PROTECTION CHECKED REFERENCE 
TIMEOUT REFERENCE IN USER MODE 

CP ERROR 

SBI NOT BUSY 

WAITING FOR READ DATA TIMEOUT 
CPU TIMEOUT 
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**************************** ENTRY 
ERROR SEQUENCE 1077. 

MACHINE CHECK 30-MAR-1994 20:55:17. 

82 . **************************** 

LOGGED ON SID 04FFFFFF 
.41 

EHMSTS 

KA86 

REV# 255. SERIAL# 4095. MFG PLANT 7 

40000802 




VMS ERROR CODE = EBOX 

MICRO TRAP VECTOR = 08 (X) 

EVMQSAV 


00000004 

EHM ENTERED 




VIRTUAL ADDRESS FOR EBOX PORT 

EBCS 


00000800 

_ REQUESTS 


EDPSR 

00000000 

ECS PARITY ERROR 

CSLINT 

04183D1F 


IBESR 

00004000 

C BUS ADDRESS = IF (X) 

C BUS DATA = 3D (X) 

INTERRUPT PRIORITY REQUEST = 8 
INTERNAL SOURCE 

I/O ADAPTER = 0. 

INTERVAL TIMER 


EBXWDl 

EBXWD2 

VASAV 

VIBASAV 

ESASAV 

ISASAV 

CPC 

MSTAT1 


00000004 

7FF593D0 

7FF593F8 

0000E7FF 

0000E7F2 

OOOOE7F2 

OOOOE7F4 

84006004 


MSTAT2 00004F00 


UOP SEL = IBOX REGISTER SELECT 
UTPR <2:0> = EBOX PORT 
ENABLE ETRAP 

TOP OF "SP STACK" 

_ CONTENT IS ONE OF THE LAST 
_ LONGWORDS WRITTEN TO MBOX 

TOP OF "SP STACK" MINUS ONE 
_ CONTENT IS ONE OF THE LAST 
_ LONGWORDS WRITTEN TO MBOX 

VIRTUAL ADDRESS FOR OP FETCH 
_ PORT REQUEST ADDRESS 
_ CALCULATION FOR OPERAND 
_ PRE-FETCH AND RESULT DELIVERY 

VIRTUAL ADDRESS OF NEXT IBUF 
_ PORT REQUEST TO FILL IBUFFER 

PC OF INSTRUCTION DURING EBOX 
_ EXECUTION AND RESULT STORAGE 

PC OF INSTRUCTION WHICH VA 
_ CALCULATION UNIT IS DOING ADDRESS 
_ CALCULATION OR OPERAND PRE-FETCH 
_ OR IS PASSING OPERAND DATA 

PC OF INSTRUCTION IN 
_ DECODE UNIT 

CO TAG MISS 
BLOCK HIT 
ABUS ADAPTER = 0. 

WORD COUNT = 0. 

CYCLE TYPE = READ REGISTER 
DEST CP = EBOX 

DIAGNOSTIC STATUS FROM SBIA 
RD COM/MSK <3:0> = F (X) 

RD DAT L/S <1:0> = 0 (X) 

ABUS BAD DATA CODE 
PAMM DATA = ARRAY #0.,SLOT #1. 
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MDECC 

00066200 

MERG 

04000100 

CSHCTL 

00000003 

MEAR 

0000007C 

MEDR 

0000001F 

FBXERR 

FFFFFFFF 

CSES 

1BD73E01 

ERROR PC 

ERROR PSL 

OOOOE7F2 

03C00004 


IOA ES 00000000 


(* DATA NOT VALID *) 

MEMORY MANAGEMENT ENABLE 

CACHE 0 ENABLE 
CACHE 1 ENABLE 

PHYSICAL ADDRESS IN PA LATCH 
AT TIME OF ERROR = 0000007C 

DATA WORD USED DURING ERROR 

(* DATA NOT VALID *) 

CS CODE = EBOX CONTROL STORE PARITY 

CS SYNDROME = 3E (X) 

CS ADDRESS = 1BD7 (X) 


Z-BIT 

INTERRUPT PRIORITY LEVEL =00. 
PREVIOUS MODE = USER 
CURRENT MODE = USER 

(* DATA NOT VALID *) 


AN/ER/INC=MACH ERR:ERRLOG.SYS_31MAR19 9 0/ENT=S=82/OUT=DP. 


Memory Error Entries Example 

Memory error log entries consist of two types: fatal and nonfatal. A nonfatal 
memory error indicates that a single bit has failed within a memory location, and 
that the ECC (error code correctable) was able to compensate for the error and 
correct the data. A fatal error indicates that multiple bits were erroneous, and 
that the ECC could not correct the data. 

Both the fatal and nonfatal memory entries are similar in their format. The 
memory error log reports can be divided into two logical areas of information. The 
first section of a memory error log report is the identification area. The second 
section contains memory controller-specific information. This data represents the 
information contained within the memory controller registers at the time of the 
memory error. Bit-to-text translation of the registers is performed and then listed 
on the right side of the report. 


**************************** ENTRY 
ERROR SEQUENCE 4. 


7 **************************** 

LOGGED ON SID 03003700 


MEMORY ERROR, 

6-MAR- 

KA730 

-1994 10:11:34.70 
REV# 0. MIC# 55. 


CSR0 


00166200 

ERROR SYNDROME = 7F 
CORRECTED ERROR, BIT #31 
ARRAY #1. IN ERROR 

CSR1 


18000000 

MEMORY MAPPING ENABLE 
ENABLE "CRD" REPORTING 

CSR2 


8100000F 

MEMORY SIZE = 2048.K 

64K RAMS PRESENT 


10-28 







ERROR LOG Examples 


**************************** ejj TRY 91> ** 

ERROR SEQUENCE 342. 

FATAL MEMORY ERROR, 4-MAR-94 08:16:45.20 

KA780 REV# 7. SERIAL# 122. 


*********************** 
LOGGED ON SID 0138207A 


CONTROLLER AT TR #5. 


PRTCFNG 00000040 

ADAPTER IS MULTI-PORT MEMORY 
PORT NUMBER = 0. 

PRTCR 00000003 

MASTER INTERRUPT ENABLE 

PORT INTERFACE INTERRUPT ENABLE 

RAM COUNT 0. 

PCSR 07870003 


IVDTCR 


AER 


CSR0 


CSR1 


MAT 


ERROR INTERRUPT ENABLE 

01870001 

INVALIDATE CACHE DEVICE ID = 0. 

8. ARRAY BOARD(S) PRESENT 
MEMORY BASE ADDRESS = 6144.K 

16A70005 

ERROR SYNDROME =05 
RDS ERROR 

ARRAY #6. IN ERROR 
ARRAY BANK #1. IN ERROR 
ERROR LOG REQUEST 

0000C2C8 

MEMORY CONTAINS VALID DATA 
PORT #2. POWERED DOWN 
PORT #3. POWERED DOWN 
ERROR INTERRUPT FROM PORT #1. 

PORT #2. OFFLINE 
PORT #3. OFFLINE 

0000380A 

PORT #0. CONNECTED TO AN SBI 

PORT #1. CONNECTED TO AN SBI 

PORT #2. NOT PRESENT 

PORT #3. NOT PRESENT 

INVALIDATION MAP PRESENT 

PORT #0. INVALIDATION ACK RECEIVED 

PORT #1. INVALIDATION ACK RECEIVED 

0000C000 


Nonfatal and User Bugchecks Entry Example 

The following is an example of a fatal bugcheck. Nonfatal and user bugcheck 
reports have the same format. These reports consist of three sections: 
identification, bugcheck reason and process information, and system register 
information. 
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VMS 

16:17:03 


SYSTEM ERROR REPORT COMPILED 3-SEP-1994 

PAGE 


******************************* ENTRY 25. 

******************************* 

ERROR SEQUENCE 15. 

DATE/TIME 22-JUL-1994 13:43:48.96 
00000003 

SYSTEM UPTIME: 90 DAYS 00:07:26 
SCS NODE: LSR3 

FATAL BUGCHECK SYS_TYPE =03 

OPERATOR, Operator requested system shutdown 


LOGGED ON: 


CPU_TYPE 00000002 
SYS TYPE 


VMS T1.0-FT3 


PROCESS NAME 
PROCESS ID 

ERROR PC 


Aut 

00010004 

00000000 000304A0 


Process Status = 08000000 00001F03, SW - 03, 
System State = 00, Current Mode = KERNEL 
VMM = 00 IPL = 31, SP Alignment = 8 
STACK POINTERS 


Previous Mode = USER 


KSP 00000000 7FF95F08 
USP 00000000 7FE63B80 

GENERAL REGISTERS 

R0 00000000 00000001 
R3 00000000 00000001 
R6 00000000 00000000 
R9 00000000 7FFA0800 
R12 00000000 00000004 
R15 FFFFFFFF 80403C30 
R18 00000000 00000000 
R21 00000000 00800000 
R24 00000000 00000000 
R27 00000000 00000002 
SP 00000000 7FF95F08 


ESP 00000000 7FF9A000 SSP 00000000 7FFA04C0 


R1 

R4 

R7 


00000000 
00000000 
00000000 
R10 00000000 
R13 00000000 
R16 00000000 
R19 00000000 
R22 FFFFFFFF 
R25 00000000 
R28 00000000 
PC 00000000 


00000000 

00000001 

00000000 

00000000 

00010100 

00000474 

00000000 

804308E8 

00000001 

00030440 

000304A0 


R2 

R5 

R8 


FFFFFFFF 
00000000 
00000000 
Rll 00000000 
R14 00000000 
R17 00000000 
R20 FFFFFFFF 
R23 88000000 
R26 00000000 


FP 

PS 


00000000 

08000000 


805ED100 

00000001 

7FFA05F8 

7FFBE3E0 

02080061 

00004000 

805C04B6 

E4000003 

00000002 

7FF95F10 

00001F03 


SYSTEM REGISTERS 



PTBR 

00000000 

000005D3 

Page Table Base Register 

PCBB 

00000000 

00B98080 

Privileged Context Block Base 

PRBR 

FFFFFFFF 

805C0000 

Processor Base Register 

SCBB 

00000002 

00000000 

System Control Block Base 

SISR 

00000000 

0000017B 

Software Interrupt Summary Register 

ASN 

00000000 

00000000 

Address Space Number 

ASTSR_ASTEN 

00000000 

0000003F 

AST Summary/AST Enable 

AT 

00000000 

0000000F 
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Unknown Entries Examples 

The following are sample reports for error log entries of unknown type. Each 
report has an identification section and an error log record section. The error log 

If e S d po?ll COntainS tW ° typ6S ° f reCOrds: inter Pretable and noninterpretable. 

Can interpret the fields of the record, the utility gives the name 
ol the field its contents, and interprets what the field is. If the utility cannot 
interpret the fields of a record, it gives the longword value of the field and its 
contents in hexadecimal format. 


**************************** ENTRY 95. * 
ERROR SEQUENCE 2. 

"UNKNOWN DEVICE" ENTRY, 4-MAR-88 10:12:12.44 


*********************** 
LOGGED ON SID 03003600 


KA730 REV# 0. MIC# 54. 


ERROR LOG RECORD 


ERF$L_SID 

03003600 


ERL$W_ENTRY 

0062 

SYSTEM ID REGISTER 

EXE$GQ_SYSTIME 

C9764980 

ERROR ENTRY TYPE 

008C2F30 

ERL$GL_SEQUENCE 0002 

64 BIT TIME WHEN ERROR LOGGED 

UCB$W_STS 

0110 

UNIQUE ERROR SEQUENCE = 2. 

UCB$B_DEVCLASS 

42 

DEVICE STATUS 

UCB$ B_DEVTYPE 

42 

DEVICE CLASS = 66. 

UCB$W_UNIT 

0000 

DEVICE TYPE = 66. 

UCB$W_ERRCNT 

0001 

PHYSICAL UNIT NUMBER = 0. 

UCB$L_OPCNT 

00000001 

UNIT ERROR COUNT = 1. 

ORB$L_OWNER 

00010004 

UNIT OPERATION COUNT = 1. 

UCB$L_DEVCHAR 

OC440007 

OWNER UIC = [001,004] 

UCB$B_SLAVE 

00 

DEVICE CHARACTERISTICS 

DDB$T_NAME 

41515403 

00000000 

00000000 

00000000 

DEVICE SLAVE CONTROLLER = 0. 

LONGWORD 1. 

00000008 

/.TQA./ 

LONGWORD 2. 

00000007 


LONGWORD 3. 

00000502 


LONGWORD 4. 

04000000 


LONGWORD 5. 

00010000 


LONGWORD 6. 

00000000 


LONGWORD 7. 

00000080 


LONGWORD 8. 

00000000 


LONGWORD 9. 

00000000 
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ERROR LOG Examples 


**************************** ENTRY 161. 
ERROR SEQUENCE 213. 

"UNKNOWN ENTRY", 4-MAR-88 11:35:15.73 

UVAXl REV# 255. MIC# 1. 


**************************** 
LOGGED ON SID 070001FF 


ERROR LOG RECORD 


ERF$L_SID 

070001FF 

SYSTEM ID REGISTER 

ERL$W_ENTRY 

0008 

ERROR ENTRY TYPE 

EXE$GQ_SYSTIME 

89953F20 

008C3E2A 

64 BIT TIME WHEN ERROR LOGGED 

ERL$GL_SEQUENCE 

00D5 

UNIQUE ERROR SEQUENCE =213. 

LONGWORD 1. 

00000001 

/..../ 

LONGWORD 2. 

00410001 



/..A./ 


Example of a Brief Report 

The following is an example of a report generated with the /BRIEF qualifier. 


SYSTEM ERROR REPORT COMPILED 25-AUG-1994 09:42 

PAGE 1. 


**************************** ENTRY 
ERROR SEQUENCE 11. 

DATA/TIME 18-JUL-1994 22:53:41.57 


DEVICE ERROR KA630 


RD32 SUB-SYSTEM, 

UNIT _ 

_RICHIE$DUA0 

DMA ADDRESS 

000000 

DSECT 

CHEAD 

DHEAD 

06 

14 

14 

RTCNT 

CSTAT 

MODE 

F0 

08 

CO 

CMD 



56 




1 . 

**************************** 


LOGGED ON: 

SID 08000000 



SYS_TYPE 00000000 

CCYL 

DCYL 

SCNT 

9C 

9C 

01 

DSTAT TERM 

ISTAT 

B2 

BD 

28 
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INSTALL Description 


The Install utility (INSTALL) improves the performance of executable and 
shareable images, especially those that run frequently, usually run concurrently 
with several processes, or require special privileges. 

The system defines installed images on internal data structures called 
known file lists. Each entry in the known file list identifies the installed 
e name and the attributes with which the file was installed. A separate 
nown file list exists for all installed images whose device, directory, and 

ram,™™ eMmple> a “ inStalled imi « es with the file name 

, ^fY-’ LUME:[MAINlme,l “ n “ EXE would on one known file list, and all 
installed images with the file name DISK$VOLUME: [TEST]filename EXE would 
be on another known file list. 

Known file lists last only while the system is operating. If the system is shut 
down or fails for any reason, you must reinstall all known images after the 
system is r ®^°ted For this reason, the site-independent startup command 
procedure, SYS$SYSTEM:STARTUP.COM, includes a series of INSTALL 
commands that install certain system programs as known images. You are 
encouraged to include additional INSTALL commands for selected images in the 
site-specific command procedure SYS$MANAGER:SYSTARTUP_VMS.COM. 
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INSTALL Usage Summary 


Use the Install utility (INSTALL) to enhance the performance of selected 
executable and shareable images, to assign enhanced privileges to images and to 
support user-written system services. The system stores the name and attributes 
of installed images on known file lists. 

Format 

INSTALL [command] 

Parameter 

command . , . 

Specifies an INSTALL command. This parameter is optional. If no command is 

specified, the utility displays its prompt and waits for command input. 

Usage Summary 

To invoke INSTALL, enter the DCL command INSTALL at the DCL prompt as 
follows: 

$ INSTALL 

The utility responds with the following prompt: 

INSTALL> 

You can then perform INSTALL operations by entering the appropriate INSTALL 
commands. Alternatively, you can enter a single INSTALL command on the same 
line as the command that invokes the utility, for example: 

$ INSTALL LIST/FULL SYS$SYSTEM:LOGINOUT 

To exit from the Install utility, enter the EXIT command at the INSTALL> 
prompt or press Ctrl/Z. Either method returns control to the DCL command level. 

The Install utility requires that you have the CMKRNL privilege to invoke it It 
requires the SYSGBL privilege to create system global sections and the LKMLBL 
privilege to create permanent global sections. 
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INSTALL 


INSTALL Commands 

This section describes and provides examples of the INSTALL commands 
Table 11-1 summarizes the INSTALL command functions. 

Table 11-1 INSTALL Command Summary 

Command Function 

Installs the specified image as a known file entry 

Installs the specified image as a known file entry (identical to ADD 
command) 

Deletes a known file entry 
Exits from INSTALL 
Describes how to use INSTALL 

Displays a description of each specified known file entry, global 
sections, and the addresses of known file entry data structures 

Deletes all known file entries installed without the /NOPURGE 
qualifier 

Deletes a known file entry (identical to DELETE command) 

Associates a known file entry with the latest version of the image file 
or modifies the attributes of an installed image 


CREATE 

DELETE 

EXIT 

HELP 

LIST 

PURGE 

REMOVE 

REPLACE 


ADD 


Installs the specified image file as a known image. 


Format 

ADD file-spec 

Parameter 

file-spec 

Names the file specification of an image to be installed as a known image. The 
file specification must name an existing executable or shareable image. If you 
omit the device and directory specification, the default SYS$SYSTEM is used 
The default file type is .EXE. 

The highest existing version of the file is used by default. However, you can 
specify another version of the file as the known version of the image. Even if 
other versions of the file exist, the version that you specify will be the version 
that satisfies all known file lookups for the image. 


Qualifiers 


/ACCOUNTING 
/NOACCOUNTING (default) 


Enabies image-level accounting for selected images even if image accounting 
is disabled on the local node (by using the DCL command SET ACCOUNTING 
/DISABLE=IMAGE). When image accounting is enabled on the local node, it logs 
all images, and the /NOACCOUNTING qualifier has no effect. 
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INSTALL 

ADD 


/EXECUTE_ONLY 

/NOEXECUTE_ONLY 

The /EXECUTE_ONLY qualifier is only meaningful to main programs. It allows 
the image to activate shareable images to which the user has EXECUTE access 
but has no READ access. All shareable images referenced by the program must 
be installed, and OpenVMS RMS uses trusted logical names (those created for 
use in EXEC or KERNEL mode). 


You cannot specify this qualifier for an executable image linked with the 
/TRACEBACK qualifier. 


/HEADER_RESIDENT 

/NOHEADER_RESIDENT 

Installs the file as a known image with a permanently resident header (native 
mode images only). The image is made permanently open even if/OPEN is not 

specified. 

/LOG 

/NOLOG .. 

Lists the newly added known file entry along with any associated global sections 

created by the installation. 


/OPEN 

/NOOPEN 

Installs the file as a permanently open known image. 


/PRIVILEGED[=(priv-name[,...])] 

/NOPRIVILEGED[=(priv-name[,...])] 

Installs the file as a known image with the privileges specified. Then, if the 
image is not located on the system volume, the image is made permanently open 
even if /OPEN is not specified. 

The /PRIVILEGED qualifier applies only to executable images. 

You cannot specify this qualifier for an executable image linked with the 
/TRACEBACK qualifier. 

You can specify one or more of the privilege names in Table 11-2. 


Table 11-2 Privileges for Installed Images 


ACNT 

ALLSPOOL 

ALTPRI 

AUDIT 

BUGCHK 

BYPASS 

CMEXEC 

CMKRNL 

DETACH 

DIAGNOSE 

DOWNGRADE 

EXQUOTA 

GROUP 

GRPNAM 

GRPPRV 

IMPORT 

LOG_IO 

MOUNT 

NETMBX 

OPER 

PFNMAP 

PHY_IO 

PRMCEB 

PRMGBL 

PRMMBX 

PSWAPM 

READALL 

SECURITY 

SETPRV 

SHARE 

(continued on next page) 
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ADD 


Table 11—2 (Cont.) Privileges for Installed Images 

SHMEM SYSGBL SYSLCK 

SYSNAM SYSPRV TMPMBX 

UPGRADE VOLPRO WORLD 


Alpha 


/PROTECTED 

/NOPROTECTED 

Installs the file as a known image that is protected from user-mode and 
supervisor-mode write access. You can only write into the image from EXEC 
or KERNEL mode. The /PROTECTED qualifier together with the /SHARE 
qualifier are used to implement user-written services, which become privileged 
shareable images. 6 


/PURGE 

/NOPURGE 


Specifies that the image can be removed by a purge operation; if you do not 

^. eC1 £^V5S E ’ y ° U Can remove the ima S e onl y by a delete or remove operation. 
The /NOPURGE qualifier is the default form of the qualifier. 


/RESIDENT=(CODE,DATA) 

/RESIDENT=(NOCODE,NODATA) 

On Alpha systems, causes image code sections or read-only data sections to be 
placed in the granularity hints code region and optionally compresses the image 
data sections, which remain located in process space. The image must be linked 
using the /SECTION_BINDING=(CODE,DATA) qualifier. ♦ 


/SHARED 

/NOSHARED 

Installs the file as a shared known image and causes creation of global sections 
for the image. The image is made permanently open even if /OPEN is not 
specified. 

/WRITABLE 

/NOWRITABLE 

InstaHs the file as a writable known image as long as you also specify the 

quallfier ' The /WRITABLE qualifier is automatically negated if the 
/NOSHARED qualifier is specified. 

Examples 

1. INSTALL> ADD/OPEN/SHARED WRKD$:[MAIN]STATSHR 

The command in this example installs the image file STATSHR as a 
permanently open, shared known image. 

2. INSTALL> ADD/OPEN/PRIVILEGED=(GROUP,GRPNAM) GRPCOMM 

The command in this example installs the image file GRPCOMM as a 
permanently open, known image with the privileges GROUP and GRPNAM. 

Any process running GRPCOMM receives the GROUP and GRPNAM 
privileges for the duration of the execution of GRPCOMM. The full name 
of GRPCOMM is assumed to be SYS$SYSTEM:GRPCOMM.EXE. 
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INSTALL 

ADD 


CREATE 

Format 

Parameter 

Qualifiers 


3. INSTALL> ADD/LOG GRPCOMM 

The command in this example installs the image file GRPCOMM as a known 
image and then displays the newly added known file entry. 


Installs the specified image file as a known image. The CREATE command is 
identical to the ADD command. 


CREATE file-spec 


Names the file specification of an image to be installed as a known image. The 
file specification must name an existing executable or shareable image. If you 
omit the device and directory specification, the default SYS$SYSTEM is used. 
The default file type is .EXE. 

The highest existing version of the file is used by default. However, you can 
specify another version of the file as the known version of the image. Even if 
other versions of the file exist, the version that you specify will be the version 
that satisfies all known file lookups for the image. 


/ACCOUNTING 
/NOACCOUNTING (default) 

Enables image-level accounting for selected images even if image accounting 
is disabled on the local node (by using the DCL command SET ACCOUNTING 
/DISABLE=IMAGE). When image accounting is enabled on the local node, it logs 
all images, and the /NOACCOUNTING qualifier has no effect. 


/EXECUTE_ONLY 

/NOEXECUTE_ONLY 

The /EXECUTE.ONLY qualifier is meaningful only to mam programs. It allows 
the image to activate shareable images to which the user has EXECUTE access 
but has no READ access. All shareable images referenced by the program must 
be installed, and OpenVMS RMS uses trusted logical names (those created for 
use in EXEC or KERNEL mode). 

You cannot specify this qualifier for an executable image linked with the 
/TRACEBACK qualifier. 


/HEADER_RESIDENT 

/NOHEADER_RESIDENT , . 

Installs the file as a known image with a permanently resident header (native 
mode images only). The image is made permanently open even if/OPEN is not 
specified. 
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CREATE 


Alpha 


/LOG 

/NOLOG 

Lists the newly created known file entry along with any associated global sections 
created by the installation. 

/OPEN 

/NOOPEN 

Installs the file as a permanently open known image. 

/PRIVILEGED[=(priv-name[,...])] 

/NOPRIVILEGED[=(priv-name[,...])] 

Installs the file as a known image with the privileges specified. Then, if the 
image is not located on the system volume, the image is made permanently open 

even if /OPEN is not specified. For a complete listing of privileges, see the ADD 
command. 

The /PRIVILEGED qualifier applies only to executable images. 

You cannot specify this qualifier for an executable image linked with the 
/TRACEBACK qualifier. 


/PROTECTED 

/NOPROTECTED 

Installs the file as a known image that is protected from user-mode and 
supervisor-mode write access. You can only write into the image from EXEC 
or KERNEL mode. The /PROTECTED qualifier together with the /SHARE 
qualifier are used to implement user-written services, which become privileged 
shareable images. 


/PURGE 

/NOPURGE 

Specifies that the image can be removed by a purge operation; if you do not 
specify /PURGE, you can remove the image only by a delete or remove operation. 
The /NOPURGE qualifier is the default form of the qualifier. 


/RESIDENT=(CODE,DATA) 

/RESIDENT=(NOCODE,NODATA) 

On Alpha systems, causes image code sections or read-only data sections to be 
placed in the granularity hints code region and optionally compresses the image 
data sections, which remain located in process space. The image must be linked 
using the /SECTION_BINDING=(CODE,DATA) qualifier. ♦ 


/SHARED 

/NOSHARED 

Installs the file as a shared known image and causes creation of global sections 
for the image. The image is made permanently open even if /OPEN is not 
specified. 


/WRITABLE 

/NOWRITABLE 

Installs the file as a writable known image as long as you also specify the 

qualifier. The /WRITABLE qualifier is automatically negated if the 
/NOSHARED qualifier is specified. 
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CREATE 


Examples 

1. INSTALL> CREATE/OPEN/SHARED WRKD$:[MAIN]STATSHR 

The command in this example installs the image file STATSHR as a 
permanently open shared known image. 

2. INSTALL> CREATE/OPEN/PRIVILEGED=(GROUP,GRPNAM) GRPCOMM 

The command in this example installs the image file GRPCOMM as a 
permanently open known image with the privileges GROUP and GRPNAM. 

Any process running GRPCOMM receives the GROUP and GRPNAM 
privileges for the duration of the execution of GRPCOMM. The full name 
of GRPCOMM is assumed to be SYS$SYSTEM:GRPCOMM.EXE. 

3. INSTALL> CREATE/LOG GRPCOMM 

The command in this example installs the image file GRPCOMM as a known 
image and then displays the newly created known file entry. 


DELETE 


Deletes a known image. 

Format 

DELETE file-spec 

Parameter 

file-spec 

Names the file specification of an image installed as a known image. 

Qualifiers 

None. 

Description 

The DELETE command deletes an entry from the known image file list. The 
image’s entry on the known file list and any global sections created for the image 
are deleted. The image file remains unaffected. Writable global sections are 
written back to disk upon their removal as known images. 

If a process is accessing global sections when the DELETE command is entered, 
the global sections are deleted only after the operation initiated by the process 
completes. However, once the command is entered, no additional processes can 
access the global sections because they are marked for deletion. 

The DELETE command is identical to the REMOVE command. 
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DELETE 


Example 


INSTALL> DELETE WRKD$:[MAIN]STATSHR 

The command in this example deletes the entry for the image STATSHR from the 
known file list. 

EXIT 


Terminates INSTALL and returns control to the DCL command level You can 
also exit from INSTALL by pressing Ctrl/Z. 

Format 

EXIT 

Parameters 

None. 

Qualifiers 

None. 


HELP 


Displays information about how to use INSTALL. 

Format 

HELP [command] 

Parameter 

command 

Specifies the name of a command for which help infomation is to be displayed. If 
you omit a command name, a list of commands is displayed and you are prompted 
for a command name. 


Examples 

1. INSTALL> HELP 

The command in this example displays a list of INSTALL topics and a Topic? 
prompt. Any topic from the list can be entered at the prompt. 
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HELP 


LIST 

Format 

Parameter 

Qualifiers 


2. INSTALL> HELP LIST 
LIST 

For display of a one-line description of the specified known image, 
or if no file is specified, then for all known images. Use with 
/FULL to obtain a multiline description. 

Format: LIST [file-spec] /qualifier 

QUALIFIER COMBINATION BEHAVIOR 

LIST [file-spec] List the known file entry for file-spec 

list List all entries 

Additional information available: 

Qualifiers 

/FULL /GLOBAL /STRUCTURE /SUMMARY 

The command in this example displays help information on the LIST 
command. 


Displays a description of each specified known image or, if no file is specified, all 
known images. 


LIST [file-spec] 


Names the file specification of an image installed as a known image. If you omit 
the file specification, INSTALL displays all known file entries. 


Displays a multiline description of the specified known image, including the 
number of accesses, the number of concurrent accesses, and the number of 
global sections created. The /FULL qualifier with the /GLOBAL qualifier shows 
information on global sections, plus the current owner and protection codes and 
access control entries. 


/GLOBAL . 

Lists global sections for any specified shared image, or if you omit the file 
specification, lists all global sections. 


/STRUCTURE 

Lists addresses of known file entry data structures. 


/SUMMARY J , , , 

Used with the /GLOBAL qualifier, displays the global section and global page 
usage on the system for local and shared memory global sections. 
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LIST 


Description 


Examples 


You can use the LIST command with the /FULL qualifier to display information 
that is useful in tuning the known file database. For example, a high entry-access 
count for an image may indicate that system performance could benefit if the 
image were installed /OPEN. Similarly, high entry-access counts for an image 
may indicate that installing the image /SHARED—that is, with global sections— 
could improve performance. For a description of global sections and global pages, 
including information on how to estimate the size of installed images, see the 
OpenVMS System Services Reference Manual. 


1. INSTALL> LIST 


The command in this example displays a single-line description of all known 
images. The description includes the file specification of the known image and 
its attributes. 


SYS$DISK:<SYSO. 
ANALIMDMP;1 
AUTHORIZE;1 
CDU; 1 
DCL; 1 
FAL; 1 
INSTALL ;1 
LOGINOUT;1 
MAIL;1 
MAIL_SERVER; 
REQUEST;1 
SET; 1 

SETAUDIT;1 
SETPO;1 
SETRIGHTS;1 
SHOW;1 
SHWCLSTR;1 
SUBMIT;1 
SYSMAN;1 


SYSCOMMON 

o 

Open 

Open 

Open 


1 


Open 

Open 

Open 

Open 

Open 

Open 

Open 

Open 


. SYSEXE>.EXE 
Prv © 
Prv 

Hdr Prv 
Hdr Shar 
Hdr Shar 

Prv 

Hdr Shar Prv 
Hdr Shar 
Hdr Shar Prv 
Prv 

Hdr Shar Prv 
Prv 

Hdr Shar Prv 
Prv 

Hdr Shar Prv 
Hdr Shar Prv 
Hdr Shar Prv 
Prv 


Lnkbl 


SYS$DISK:<SYS0.SYSCOMMON.SYSLIB>.EXE 


ANALIMDMPSHR;1 
CONVSHR;1 


Prv 


DCLTABLES;1 

Open Hdr Shar 

Lnkbl 


LIBOTS;1 

Open Hdr Shar 

Lnkbl 

Resid 

LIBRTL;1 

Open Hdr Shar 

Lnkbl 

Resid 

MAILSHR;1 

Open Hdr Shar 

Lnkbl 


O File specification of the known image 
© Attribute of known image, as follows: 
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LIST 


Attribute 

Meaning 

ACNT 

Image accounting is enabled for the image 
(/ACCOUNTING). 

tCMODE 

Image is in compatibility mode, set by the VAX-11 RSX 


Linker. 

HDR 

Image header is permanently resident (/HEADER_ 
RESIDENT). 

LNKBL 

Image is not executable; it is a shareable (linkable) 
image set by the OpenVMS Linker. 

NOPURG 

Image cannot be removed by a purge operation; it 
can only be removed by a delete or remove operation 


(/NOPURGE). 

OPEN 

Image is permanently open (/OPEN). 

PROT 

Image contains protected code (/PROTECTED). 

PRV 

Image has privileges (/PRIVILEGE^. 

tRESID 

Image is resident (/RESIDENT). 

SHAR 

Image is shared (/SHARED). 

tSHM 

Image has global sections installed in shared memory 
(/SHARED). 

WRT 

Image is writable (/WRITABLE). 

XONLY 

Only execute access to image is allowed (/EXECUTE_ 
ONLY). 

tVAX specific 
^Alpha specific 


INSTALL> LIST/RESIDENT 


Alpha 


The command in this Alpha example displays a single-line description of all 
resident images. The description includes the location in memory, the size of 
the code sections, and the type of section. 

System Resident Sections 

SYS$DISK:<SYS0.SYSCOMMON.SYSLIB>.EXE 
CMA$TIS_SHR;1 


Base VA 

End VA 

Length 

Type 

80490000 

80490A00 

00000A00 

Resident Code 

7FC04000 

7FC14000 

7FC34000 

7FC04A00 

7FC14200 

7FC34200 

00000A00 

00000200 

00000200 

Linkage 

Writeable data 
Writeable data 

DECC$SHR;1 



Base VA 

End VA 

Length 

Type 

80548000 

805D2000 

805D1CO0 

805D2400 

00089C00 

00000400 

Resident Code 
Resident Code 
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7FE34000 

7FE4B800 

00017800 

Linkage 

7FE54000 

7FE59A00 

00005A00 

Writeable data 

7FE64000 

7FE64800 

00000800 

Read-only data 

7FE84000 

7FE84200 

00000200 

Writeable data 

7FE94000 

7FE94200 

00000200 

Demand-zero 

7FEA4000 

7FEA7000 

00003000 

Demand-zero 

7FEB4000 7FEB5800 

DPML$SHR;1 

00001800 

Writeable data 

Base VA 

End VA 

Length 

Type 

80492000 

80547600 

000B5600 

Resident Code 

7FC44000 

7FC6FA00 

0002BA00 

Read-only data 

7FC74000 

7FC88200 

00014200 

Linkage 

7FC94000 

7FC94400 

00000400 

Writeable data 

7FCA4000 

7FCCE600 

0002A600 

Read-only data 

7FD94000 

7FD95000 

00001000 

Writeable data 

LIB0TS;1 

Base VA 

End VA 

Length 

Type 

80482000 

8048F600 

OOOOD 6 OO 

Resident Code 

7FBC4000 

7FBC6600 

00002600 

Read-only data 

7FBD4000 

7FBD5A00 

00001A00 

Linkage 

7FBF4000 

7FBF4200 

00000200 

Writeable data 

LIBRTL;! 

Base VA 

End VA 

Length 

Type 

80400000 

80481A00 

00081AOO 

Resident Code 

7FB54000 

7FB64800 

00010800 

Linkage 

7FB74000 

7FB75000 

00001000 

Writeable data 

7FB84000 

7FB8D600 

00009600 

Read-only data 

7FB94000 

7FB94200 

00000200 

Writeable data 

7FBA4000 

7FBA5000 

00001000 

Demand-zero 

7FBB4000 

7FBB5400 

00001400 

Writeable data 


The five images in this example are the special images that can be installed 
with shareable linkage. Any other image installed resident would have only 
resident code or resident data sections. ♦ 

3. INSTALL> LIST/FULL LOGINOUT 

The command in this example displays a multiline description of the known 
image LOGINOUT. 

SYS$DISK:<SYS0.SYSCOMMON.SYSEXE>.EXE 

LOGINOUT; 3 Open Hdr Shar Priv 

Entry access count = 44 O 

Current / Maximum shared = 3 / 5 0 
Global section count = 2 0 

Privileges = CMKRNL SYSNAM TMPMBX EXQUOTA SYSPRV © 

© Number of times known file entry has been accessed by this node since it 
became known. 

0 First number indicates the current count of concurrent accesses of the 
known file. The second number indicates the highest count of concurrent 
accesses of the file since it was installed. This number appears only if the 
image is installed with the /OPEN qualifier. 

0 Number of global sections created for the known file; appears only if the 
image is installed with the /SHARED qualifier. 
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O Translation of the privilege mask; appears only if the image is installed 
with privileges. 

INSTALL> LIST/GLOBAL 

The command in this example displays all global sections for shared images. 

System Global Sections O 

LBRSHR_004 © (01000001) © WRT © PRM © SYS © Pagcnt/Refcnt=l/0© 

CRFSHR_003 (010003E8) WRT PRM SYS Pagcnt/Refcnt=l/1 


27 Global Sections Used, 828/3268 Global Pages Used/Unused © 

O Display of global sections in memory. 

@ Name of global section. 

© Version number (in hexadecimal) of global section; for shareable 

images only, the high-order byte (01 in CRFSHR_003) contains major 
identification, and low-order bytes (0003E8 in CRFSHR_003) contain 
minor identification determined by the programmer at link time. For 
executable images, the number is a known unique value determined by 
the system. 

© Global section is writable. 

© Global section is permanent; TMP indicates a temporary global section, 
which would be created by a program other than the Install utility. 

© Global section is systemwide; GRP and a group number indicate a 
groupwide section, which would be created by a program other than 
Install. 

Q Number of pages (VAX) or pagelets (Alpha) in the section and number 
of page table entries currently mapped to this global section. For a 
more detailed discussion of mapping global sections, see the OpenVMS 
Programming Concepts Manual. 

© Number of global sections created, number of global pages used, and 
number of global pages unused in local memory. Note that, because of 
arithmetic rounding, the number of global sections created will sometimes 
be greater than the SYSGEN parameter GBLSECTIONS. When the size 
of the system header is being computed, the values of the GBLSECTIONS 
and SYSMWCNT parameters are combined with the size of the fixed part 
of the process header. The result is rounded up to the next page boundary. 
This rounding process sometimes adds space to the global section table, 
depending on the values of the two SYSGEN parameters and the amount 
of system paging that preceded the running of INSTALL to create all of 
the global sections. 
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5. INSTALL> LIST/GLOBAL/FULL 


The command in this example displays a complete listing of global sections 

or shared images. The /FULL qualifier adds owner and protection codes to 
the display. 


System Global Sections 
NM_MAILSHR_003 (741A6919) 
NM_MAILSHR_002 (741A6919) 
NM_MAILSHR_0 01 (741A6919) 
Owner: 
Protection: 


PRM SYS Pagcnt/Refcnt=10/0 

PRM SYS Pagcnt/Refcnt=l/0 

PRM SYS Pagcnt/Refcnt=ll/0 

[1,4] O 

S:RWED,0:RWED,G:RWED,W:RE © 


© UIC of the owner of the global section 
© Type of access allowed for the image 


PURGE 


Deletes all known file entries for images installed without the /NOPURGE 
qualifier. 


Format 

PURGE 

Parameters 

None. 


Qualifiers 

None. 


Description 


The PURGE command deletes 
the /NOPURGE qualifier. 


all known file entries for images installed without 


If a process is accessing global sections when the PURGE command is entered 
the global sections are deleted only after the operation initiated by the process 
completes. However, once the command is entered, no additional processes can 
access the global sections because they are marked for deletion 


Example 


INSTALL> PURGE 

^ command in this example deletes all images except those installed with the 
/NOPURGE qualifier. The image files remain unaffected. Writable global sections 
are written back to disk upon their removal as known images. 
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INSTALL 

REMOVE 


REMOVE 

Removes an entry from the known image file list. The REMOVE command is 
identical to the DELETE command. 

Format 

REMOVE file-spec 

Parameter 

file-spec 

Names the file specification of the known image file entry. 


Qualifiers 

None. 


Description 

The REMOVE command deletes an entry that appears in the known image file 
list. The image’s entry on the known file list and any global sections for the 
image are deleted. The image file remains unaffected. Writable global sections 
are written back to disk upon their removal as known images. 

If a process is accessing global sections when the REMOVE command is entered, 
the global sections are deleted only after the operation initiated by the process 
completes. However, once the command is entered, no additional processes can 
access the global sections because they are marked for deletion. 


Example 

INSTALL> REMOVE GRPCOMM 

The command in this example deletes the entry for the known image GRPCOMM 
from the known image file list. 


REPLACE 

Associates a known image with the latest version of the image file, or modifies 
the attributes of an installed image. 

Format 

REPLACE file-spec 

Parameter 

file-spec 

Names the file specification of an image installed as a known image. 
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INSTALL 

REPLACE 


Qualifiers 


/ACCOUNTING 
/NOACCOUNTING (default) 

En f ble u S , ™ age ' level accounting for selected images even if image accounting 

/nroAox ^ ° n the l0CaI n ° de (by using the DCL command SET ACCOUNTING 
/JJ1SABLE=IMAGE) When image accounting is enabled on the local node, it logs 
all images, and the /NOACCOUNTING qualifier has no effect. 

/EXECUTE_ONLY 

/NOEXECUTE_ONLY 

The /EXECUTE_ONLY qualifier is meaningful only to main programs. It allows 
the image to activate shareable images to which the user has execute access but 
as no read access. All shareable images referenced by the program must be 

installed, and OpenVMS RMS uses trusted logical names, those created for use in 
executive or kernel mode. 

AnSS**? A^ edfy , thiS qualifier for an executable image linked with the 
/1KAOEBACK qualifier. 

/HEADER_RESIDENT 

/NOHEADER_RESIDENT 

Installs the file as a known image with a permanently resident header (native 

mode nn ages only). The image is made permanently open even if/OPEN is not 
specified. 

/LOG 

/NOLOG 

Lists the newly created known file entry along with any associated global sections 
created by the installation. 

/OPEN 

/NOOPEN 

Installs the file as a permanently open known image. 

/PRIVILEGED[=(priv-name[,...])] 

/NOPRIVILEGED[=(priv-name[,...])] 

Installs the file as a known image with the privileges specified. Then, if the 
imag e is not located on the system volume, the image is made permanently open 

even if/OPEN is not specified. For a complete listing of privileges, see the ADD 
command. 

The /PRIVILEGED qualifier applies only to executable images. 

You cannot specify this qualifier for an executable image linked with the 
/TRACEBACK qualifier. 

/PROTECTED 

/NOPROTECTED 

Installs the file as a known image that is protected from user-mode and 
supervisor-mode write access. You can only write into the image from executive 
or kernel mode. The /PROTECTED qualifier together with the /SHARE qualifier 

are used to implement user-written services, which become privileged shareable 
images. 
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INSTALL 

REPLACE 


Alpha 


/PURGE 

Specifies that the image can be removed by a purge operation; if you do not 
specify /PURGE, it can be removed only by a delete or remove operation, ibe 
/NOPURGE qualifier is the default form of the qualifier. 

/RESIDENT=(CODE,DATA) 

/RESIDENT=(NOCODE,NODATA) 

On Alpha systems, causes image code sections or read-only data sections to be 
placed in the granularity hints code region and optionally compresses the image 
data sections, which remain located in process space. The image must be linked 
using the /SECTION_BINDING=(CODE,DATA) qualifiers 

/SHARED 

/NOSHARED „ , , , ,. 

Installs the file as a shared known image and causes creation of gobal sections 
for the image. The image is made permanently open even if /OPEN is not 
specified. 


/WRITABLE 

/NOWRITABLE , . ., .. 

Installs the file as a writable known image as long as you also specify the 
/SHARED qualifier. The /WRITABLE qualifier is automatically negated it the 
/NOSHARED qualifier is specified. 


Description 


The REPLACE command updates a known file to the latest version found in the 
specified directory. 


You can use the REPLACE command to modify the attributes of currently 
installed images. Either specify new qualifiers, or change the value of qualifiers 
used when installing the image with the ADD (or CREATE) command. If you 
specify no qualifiers, the new image retains the same attributes as the old one. it 
the old image was installed with the /SHARED qualifier, the global sections are 
recreated, probably with new identifiers. 


If a process is accessing global sections when the REPLACE command is entere , 
the global sections are deleted only after the operation initiated by the process 
completes. However, once the command is entered, no additional processes can 
access the global sections because they are marked for deletion. 


Example 

INSTALL> REPLACE GRPCOMM /ACCOUNTING/NOOPEN 

The command in this example replaces the known image GRPCOMM with the 
latest version of the image, while enabling image accounting and removing t e 
OPEN attribute from this version. 

The full name of the file specification is assumed to be 
SYS$SYSTEM:GRPCOMM.EXE. 
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LAN Control Program (LANCP) Utility 
































LANCP Description 

^ he T L .^ Control Program (LANCP) utility allows you to configure and control 
the LAN software on OpenVMS systems. You can use LANCP to: 

Obtain LAN device counters, revision, and configuration information 

• Change the operational parameters of LAN devices on the system 

• Maintain the LAN permanent and volatile device and node databases 

• Update the firmware on LAN devices 

Control the LANACP LAN Server process (including MOP downline load 
server related functions) 

• Initiate MOP console carrier and MOP trigger boot operations 














LANCP Usage Summary 


You can use the LANCP utility to: 

• Set LAN parameters to customize your LAN environment. 

• Display LAN settings and counters. 

• Provide Maintenance Operations Protocol (MOP) downline load support for 
devices such as terminal servers, x-terms, and LAN-based printers, and for 
booting satellites in a VMScluster environment. This provides an alternative 
to the traditional method of using DECnet for OpenVMS or DECnet/OSI 
software. 

Format 

LANCP [command] 

Parameter 

command 

Specifies a LANCP command. This parameter is optional. If no command is 
specified, the utility displays its prompt and waits for command input. 

Usage Summary 

To invoke LANCP, enter the following command at the DCL command prompt: 

$ RUN SYS$SYSTEM:LANCP 

The LANCP utility responds by displaying the LANCP> prompt, at which you 
can enter any of the LANCP commands described in this chapter. 

You can also invoke LANCP by using the MCR command or by defining LANCP 
as a foreign command. 

To use the MCR command, at the DCL command prompt, enter: 

$ MCR LANCP 

To define LANCP as a foreign command, either at the DCL prompt or in a startup 
or login command file, enter: 

$ LANCP :== $SYS$SYSTEM:LANCP 

Then you can enter the command LANCP at the DCL prompt to invoke the utility 
and enter LANCP commands. 
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LANCP Usage Summary 


When you enter the LANCP or MCR LANCP command: 

• Without specifying any command qualifiers, the LANCP utility displays the 
^ANCP> prompt, at which you can enter commands. 

With command qualifiers, the LANCP utility terminates after it executes the 
command and returns you to the DCL command prompt. 

—-- Note _ _ 

Some LANCP commands require special privileges. 


To exit from the LANCP utility, enter the EXIT command at the LANCP> prompt 
or press Ctrl/Z. 

For information about the LANCP utility, enter the HELP command at the 
LANCP> prompt. 
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LANCP Usage Summary 


LANCP Commands 

This section describes and provides examples of the LANCP commands. 
Table 12-1 summarizes the LANCP commands. 


Table 12-1 LANCP Commands 


Command 

Function 

@ (Execute Procedure) 

Executes a command procedure. 

CLEAR DEVICE 

Deletes a device from the LAN volatile device 
database. 

CLEAR MOPDLL 

Clears MOP downline load counters for all nodes and 
devices. 

CLEAR NODE 

Deletes a node from the LAN volatile node database. 

CONNECT NODE 

Connects to a LAN device, such as a terminal server, 
that implements a management interface using the 

MOP console carrier protocol. 

DEFINE DEVICE 

Enters a device into the LAN permanent device 
database or modifies an existing entry. 

DEFINE NODE 

Enters a node into the LAN permanent node database 
or modifies an existing entry. 

EXIT 

Stops execution of LANCP and returns control to the 
DCL command level. 

HELP 

Provides online help information about the LANCP 
utility. 

LIST DEVICE 

Displays information in the LAN permanent device 
database. 

LIST NODE 

Displays information in the LAN permanent node 
database. 

PURGE DEVICE 

Deletes a device from the LAN permanent device 
database. 

PURGE NODE 

Deletes a node from the LAN permanent node 
database. 

SET ACP 

Modifies the operation of the LANACP LAN Server 
process. 

SET DEVICE (parameters)!: 

Modifies device parameters. 

SET DEVICE (volatile device 

Enters a device into the LAN volatile device database 

database) 

or modifies an existing entry. 

SET NODE 

Enters a node into the LAN volatile node database or 
modifies an existing entry. 

SHOW CONFIGURATION 

Displays a list of LAN devices on the system. 

SHOW DEVICE 

Displays information in the LAN volatile device 
database. 

SHOW LOG 

Displays recent downline load activity. 

SHOW MOPDLL 

Displays the current state of MOP downline load 
services. 

SHOW NODE 

Displays information in the LAN volatile node 
database. 


$ Alpha only 


(continued on next page) 
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LANCP 


Table 12-1 (Cont.) 

LANCP Commands 

Command 

Function 

SPAWN 

TRIGGER NODE 
UPDATE DEVICE^ 

Creates a subprocess of the current process. 

Issues a request to reboot to a remote node. 

Updates firmware image for a device. 

tAlpha only 


@ (Execute Procedure) 

Executes a command procedure or requests the command interpreter to read 
subsequent command input from a specific file or device. 

Format 

@ file-spec 

Parameter 

file-spec 

Specifies either the input device or the file for the preceding command, or the 
command procedure to be executed. 

Qualifiers 

None. 

Example 

$ CREATE COUNT.COM 
SHOW DEVICE/COUNTERS 
SPAWN WAIT 01:00:00 
©COUNT 

| Ctrl/Z | 

$ RUN SYS$SYSTEM:LANCP 
LANCP> ©COUNT 
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LANCP 

@ (Execute Procedure) 


Device Counters EXAO: 


Value 

Counter 

4294967295 

Seconds since last zeroed 

38731696 

Data blocks received 

28378137 

Multicast blocks received 

2621447 

Receive failure 

4294967295 

Bytes received 

3203299230 

Multicast bytes received 

1 

Data overrun 

13771761 

Data blocks sent 

672064 

Multicast packets transmitted 

662415 

Blocks sent, multiple collisions 

502863 

Blocks sent, single collision 

1056303 

Blocks sent, initially deferred 

1462759444 

Bytes sent 

76562996 

Multicast bytes transmitted 

40042529 

Send failure 

0 

Collision detect check failure 

0 

Unrecognized frame destination 

0 

System buffer unavailable 

0 

User buffer unavailable 


T his example creates and runs a command procedure, COUNT.COM, that 
displays device counters once every minute. 


CLEAR DEVICE 


Deletes a device from the LAN volatile device database. Requires SYSPRV 
privilege. 


Format 

CLEAR DEVICE device-name 

Parameter 

device-name 

Supplies the LAN controller device name. The device name has the form ddcu 
where dd is the device code, c is the controller designation, and u is the unit 
number. LAN devices are specified as the name of the template device which is 
unit 0. For example, the first DE435 Ethernet device is specified as EWAO, the 
second as EWBO. 

For example, you can specify a DEMNA controller as either EXA, EXAO, or 
EXAO:. To select all LAN devices, omit the device name and include the /ALL 
qualifier. 

Qualifier 

/ALL 

Deletes all LAN devices in the LAN volatile device database. If you specify a 
device name, all matching LAN devices are selected, for example: E to select all 
Ethernet devices, F for FDDI, I for Token Ring, EW to select all Ethernet PCI 
Tulip devices. 
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LANCP 
CLEAR DEVICE 


Example 

LANCP> CLEAR DEVICE EXAO 

This command deletes device EXAO from the LAN volatile device database. 


CLEAR MOPDLL 


Format 

This command clears MOP downline load counters from the LAN volatile device 
and node databases for all nodes and devices. Requires SYSPRV privilege. 

CLEAR MOPDLL 


Parameters 

None. 


Qualifiers 

None. 

Example 

LANCP> CLEAR MOPDLL 

This command clears MOP downline load counters from the LAN volatile device 
and node databases for all nodes and devices. 


CLEAR NODE 


Format 

Deletes a node from the LAN volatile node database. Requires SYSPRV privilege. 

CLEAR NODE node-name 

Parameter 

node-name 

Supplies the name of a node in the LAN volatile node database. 

Qualifier 

/ALL 

Deletes all LAN nodes in the LAN volatile node database. If you specify a node 
name, all matching nodes are selected; for example, A/ALL deletes all nodes 
whose name begins with A. 
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LANCP 
CLEAR NODE 


Example 

LANCP> CLEAR NODE VAXSYS 

This command deletes the node VAXSYS from the LAN volatile node database. 


CONNECT NODE 


Opens a MOP console carrier connection to the specified node. This allows a local 
terminal to act as the console for a remote system. 

Format 

CONNECT NODE node-specification 

Parameter 

node-specification 

Supplies either the node name or the node address of the target node. If you 
supply the node name, the node address is obtained by looking up the node 
name in the LAN volatile node database. If you supply the node address, the 
corresponding node need not be defined in the LAN volatile node database. The 
canonical form of the address consists of 6 hexadecimal byte characters separated 
by hyphens. Use a colon as the separator character to indicate the bit-reversed 
form of the address. 

Qualifiers 

IDEV\CE=device-name 

Specifies the LAN controller device name to be used for the connection. For 
example, you can specify a DEMNA controller as EXA, EXAO, or EXAO:. 

/DISCONNECT= disconnect-character 

Specifies a character that you can use to terminate the connection to the 
remote node. To terminate a connection, type Ctrl Jdisconnect-character. You 
can select any ASCII character from @ through Z, except C, M, Q, S, Y; the 
default disconnect character is D. 

/PASSWORDS 6hexdigits . 

Supplies the password to be used when the connection is initiated, in hexadecimal 
(for example, /PASSWORD=0123456789ABCDEF). The default password is zero. 
You can omit leading zeros. 

m or m 

Indicates that MOP Version 3 or Version 4 formatted messages, respectively, are 
to be used to make the connection. By default, LANCP determines the format 
by sending MOP Request ID messages to the remote node first in MOP Version 
4 format, then in Version 3 format, repeating this process until a response is 
received or timeout occurs. 

You can specify the format: 

• To allow connection to nodes that do not support Request ID messages 
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LANCP 
CONNECT NODE 

• As a means of getting around implementation problems with one of the 
formats 

Examples 

1. CONNECT NODE GALAXY/DEVICE=EWAO 

This command attempts a console-carrier connection to node GALAXY using 
the Ethernet device EWAO. 

2. CONNECT NODE 08-00-2B-ll-22-33/DEVICE=EWA0/PASSWORD=0123456789AB 

This command attempts a console-carrier connection to the given node 
address using the Ethernet device EWAO, with the specified password. 

DEFINE DEVICE 


Enters a device into the LAN permanent device database or modifies an existing 
entry. Requires SYSPRV privilege. 

Format 

DEFINE DEVICE device-name 

Parameter 

device-name 

Supplies the name of a device to be added to the LAN permanent device database 
or an entry to be modified. The device name has the form ddcu where dd is 
the device code, c is the controller designation, and u is the unit number. LAN 
devices are specified as the name of the template device which is unit 0. For 
example, the first DE435 Ethernet device is specified as EWAO, the second as 


Qualifiers 

/ALL 

Defines data for all LAN devices in the LAN permanent device database. If you 
specify a device name, all matching LAN devices are selected, for example: E 
to select all Ethernet devices, F for FDDI, I for Token Ring, EW to select all 
Ethernet PCI Tulip devices. 

/MOPDLL=(enable-option, exclusive-option, size-option, 
knownclientsonly-option) 

Provides the MOP downline load service settings for the device. 

Note that defaults apply to creation of an entry in the device database. If an 
existing entry is being modified, fields not specified remain unchanged. 

You can specify the following keywords with this qualifier: 

• enable-option 

ENABLE 

DISABLE (default) 
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LANCP 

DEFINE DEVICE 


Specify ENABLE or DISABLE to indicate that MOP downline load service 
should be enabled or disabled for the device. 

• exclusive-option 

EXCLUSIVE 
NOEXCLUSIVE (default) 

Specify EXCLUSIVE to indicate that no other provider of MOP downline load 
service is allowed on the specified LAN device at the same time as LANACP. 
Specify NOEXCLUSIVE to indicate that the LAN MOP downline load service 
can coexist with other implementations (in particular, the DECnet Phase IV 
implementation that operates the MOP protocol in shared mode). 

• size-option 

SIZE=i )alue 

Use SIZE=ua/ue to specify the size in bytes of the file data portion of each 
downline load message. The permitted range is 246 to 1482 bytes. The 
default value is 246 bytes, which should allow any client to load properly. 

Note that some clients may not support the larger size. 

The recommended size for better load performance and less server overhead is 
the largest size that results in successful loads of all clients. The 1482 value 
is derived from the maximum packet size for CSMA/CD (Ethernet) of 1518 
bytes less the 802e header and CRC (26 bytes) and MOP protocol overhead 
(10 bytes). 

You can override the size on a per-node basis. See DEFINE NODE and SET 
NODE for details. 

• knownclientsonly-option 

KNOWNCLIENTSONLY 
NOKNOWNCLIENTSONLY (default) 

Specify KNOWNCLIENTSONLY to indicate that MOP downline load requests 
should be serviced only for clients defined in the LAN permanent node 
database. When NOKNOWNCLIENTSONLY is selected, LANACP searches 
the LAN$DLL directory for any images requested by clients that are not 
defined in the LAN permanent node database. 


Adds LAN devices that are not currently in the LAN permanent device database 
to that database. The initial entry for the device uses default values for all 
parameters To update the permanent database with current information from 
the volatile database, use the DEFINE DEVICE command with the /VOLATILE. 
DATABASE qualifier. You can combine the /UPDATE and /VOLATILE. 
DATABASE qualifiers in a single DEFINE DEVICE command. 

/VOLATILE.DATABASE 

Updates the device entries in the LAN permanent device database with any data 
currently set in the volatile database. This allows you to update the permanent 
database after changing data in the volatile database, rather than repeating 
the commands for each updated entry to apply the changes to the permanent 
database. 
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Examples 


LANCP 
DEFINE DEVICE 


1. LANCP> DEFINE DEVICE EXAO/MOPDLL=(ENABLE,EXCLUSIVE) 

This command defines LAN device EXAO to enable LANACP MOP downline 
load service in exclusive mode. The setting of the KNOWNCLIENTSONLY 
and SIZE characteristics are not changed. If the device entry does not 

currently exi st in the LAN permanent device database, these settings are set 
to the defaults. 

2. LANCP> DEFINE DEVICE/ALL/MOPDLL=NOEXCLUSIVE 

This command sets all LAN devices defined in the LAN permanent device 
database to nonexclusive mode for LANACP MOP downline load service. 

3. LANCP> DEFINE DEVICE/ALL/UPDATE/VOLATILE_DATABASE 

This command enters all Ethernet devices into the LAN permanent device 
atabase and updates the entry to include the current parameter values. 


DEFINE NODE 


Format 


Enters a node into the LAN permanent node database or modifies an 
entry. Requires SYSPRV privilege. 


existing 


DEFINE NODE node-name 


Parameter 

node-name 

Supplies the name of a node to be added to the LAN permanent node database 
or an entry to be modified. Typically, the node name is the same as that given in 
the system parameter SCSNODE, but it does not need to be. The node name is 
limited to 63 characters in length. 

Qualifiers 

/ADDRESS =node-address 
/NOADDRESS (default) 

Associates a LAN address with the node name. Specify the address as 6 bytes 
m hexadecimal notation, separated by hyphens. The address does not have to be 

unique (as might be the case when the address is not known, so a nonexistent 
address is specified). 


If multiple node addresses are to be associated with a node name, each 

vavovow* 111 ^ be given as a node name with an extension, for example, 
VAXbYS.EXA for the EXA device on node VAXSYS, or VAXSYS 1 for the first 
LAN device on node VAXSYS. 

the /ADDRESS qualifier, the setting remains unchanged. 
The /NOADDRESS qualifier clears the field. 
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LANCP 

DEFINE NODE 


Defines data for all nodes in the LAN permanent node database. If you specify a 
node name, all matching nodes are selected; for example, A/ALL selects all nodes 
beginning with A. 


/BOOT_TYPE=boof-opf/'on 

/NOBOOTJYPE __ 

Indicates the type of processing required for downline load requests. You can 
specify one of the following keywords with this qualifier. 


• VAX_SATELLITE—a VMScluster VAX satellite boot 


• ALPHA_SATELLITE—a VMScluster Alpha satellite boot 

• OTHER—the specified image; a noncluster satellite load that does not require 
additional data 


The distinction is necessary, because VMScluster satellite loads require additional 
cluster-related data be appended to the load image given by the /FILE qualifier. 
The default value is OTHER. 


If you do not specify the /BOOTTYPE qualifier, the setting remains unchanged. 
The /NOBOOT_TYPE qualifier clears the field. 


/FILE=f//e-spec 

Supplies the file name of a boot file to be used when the downline load request 
does not include a file name (for example, with VMScluster satellite booting). The 
file specification is limited to 127 characters. 

If no file name is specified, VMScluster satellite loads default to APB.EXE where 
the boot type is set to ALPHA and NISCS_LOAD.EXE where the boot type is set 
to VAX. 

If you do not specify the /FILE qualifier, the setting remains unchanged. The 
/NOFILE qualifier clears the field. 


/ROOT= directory-specification 

Supplies the directory specification to be associated with the file name. For 
cluster satellite service, the /ROOT qualifier specifies the satellite root directory. 
For noncluster service, this qualifier specifies the location of the file. If the hie 
specification or the file name given in the boot request includes the directory 
name, this qualifier is ignored. The directory specification is limited to 127 
characters. 

If you do not specify the /ROOT qualifier, the setting remains unchanged. The 
/NOROOT qualifier to clears the field. 

/SIZE= value 

Specifies the size in bytes of the file data portion of each downline load message. 
The default is the load data size specified for the device. The permitted range is 
246 to 1482 bytes. Use a larger size for better load performance and less server 
overhead. 


If you do not specify the /SIZE qualifier, the setting remains unchanged. The 
/NOSIZE qualifier clears the setting. 
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LANCP 
DEFINE NODE 


/V3 

/NOV3 

Indicates that only MOP Version 3 formatted messages are to be used for 
downline load purposes, regardless of the requested format. This allows systems 
that have a problem with MOP Version 4 booting to load. This qualifier causes 
the requesting node to fail over from MOP Version 4 to MOP Version 3 when no 
response has been made to a MOP Version 4 load request. 

If you do not specify the /V3 qualifier, the setting remains unchanged. The /NOV3 
qualifier clears the setting. 

/VOLATILE_DATABASE 

Updates the node entries in the LAN permanent node database with any data 
currently set in the volatile database. This allows you to update the permanent 
database after changing data in the volatile database, rather than repeating 

database iandS ^ ^ UP<lated 6ntry t0 apply the chan e es to the permanent 


Examples 


1. DEFINE NODE GALAXY/ADDRESS=08-00-2B-ll-22-33 - 
/FILE=NISCS_LOAD.EXE - 
/ROOT=$64$DIA14:<SYS10.> - 
/BOOT_TYPE=VAX_SATELLITE 


This command sets up node GALAXY in the LAN permanent node database 
for booting as a VAX satellite into a VMScluster. 

The NISCS_LOAD.EXE file is actually located on $64$DIA14- 
<SYS10.SYSCOMMON.SYSLIB>. The <SYSCOMMON.SYSLIB> is supplied 
by the LANACP LAN Server process and is not included in the root definition. 

2. DEFINE NODE ZAPNOT/ADDRESS=08-00-2B-ll-22-33 - 

/FILE=APB.EXE - 
/ROOT=$64$DIA14:<SYS10.> - 
/BOOT_TYPE=ALPHA_SATELLITE 

™ S o C ,° mmand sets up node ZAPN0T for booting as an Alpha satellite into a 
VMScluster. 

The APB.EXE file is actually located on $64$DIA14: 
<SYS10.SYSCOMMON.SYSEXE>. Note that the <SYSCOMMON.SYSEXE> 
is supplied by the LANACP LAN Server process and is not included in the 
root definition. 

3. DEFINE NODE CALPAL/ADDRESS=08-00-2B-ll-22-33 - 

/FILE=APB_061.EXE 

This command sets up node CALPAL for booting an InfoServer image. It 
defines the file that should be loaded when a load request without file name 
is received from node CALPAL. 

Because the file does not include a directory specification, the logical 
name LAN$DLL defines where to locate the file. You could give directory 
specification using the file name or by using the /ROOT qualifier. 

Note that specifying the file name explicitly in the boot command overrides 
the file name specified in the node database entry. 
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LANCP 

EXIT 


EXIT 


Stops execution of LANCP and returns control to the DCL command level. You 
can also enter Ctrl/Z at any time to exit. 


Format 

EXIT 

Parameters 

None. 

Qualifiers 

None. 

Example 

LANCP> EXIT 
$ 

T his command stops execution of LANCP and returns control to the DCL 
command level. 


HELP 


Provides online help information about the LANCP utility. 


Format 


HELP [topic] 


Parameter 


Specifies a subject for which you want information—a LANCP command or 
LANCP command and command keyword. If you enter the HELP command with 
a command name only, such as HELP SET, LANCP displays a list of all of the 
command keywords used with the SET command. 


Qualifiers 

None. 


12-16 








LANCP 

HELP 


Example 

LANCP> HELP DEFINE DEVICE 
DEFINE 
DEVICE 

DEVICE device-name/qualifiers 
DEVICE/ALL/qualifiers 

Sets device specific parameters for the specified LAN devices. 

Requires SYSPRV privilege. 

Additional information available: 

Parameters Qualifiers 

/ALL /MOPDLL /VOLATILE_DATABASE /UPDATE 

Examples 

DEFINE DEVICE Subtopic? 

This command provides online help for the LANCP DEFINE DEVICE command. 

LIST DEVICE 


Displays information in the LAN permanent device database. 


Format 

LIST DEVICE device-name 

Parameter 

device-name 

Supplies the LAN controller device name. The device name has the form ddcu 
where dd is the device code, c is the controller designation, and u is the unit 
number. LAN devices are specified as the name of the template device which is 
unit 0. For example, the first DE435 Ethernet device is specified as EWAO, the 
second as EWBO. 

For example, you can specify a DEMNA controller as EXA, EXAO, or EXAO:. 
This refers to the LAN template device, for which is maintained most of the 
device parameters and counters. Also, the device name can refer to a device unit 
representing an actual user or protocol. For example, the cluster protocol can be 
started on a device as EWA1. You can specify a device unit to view unit-specific 
parameter information. 

If you do not specify a device name, all devices are displayed. 

If you specify a device name, all matching LAN devices are displayed, for 
example: E to select all Ethernet devices, F for FDDI, I for Token Ring, EW to 
select all Ethernet PCI Tulip devices. 
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_ Note _ 

If you do not specify a qualifier, the utility displays the matching devices 
without additional information. 


Qualifier 

/MOPDLL 

Displays MOP downline load information. 
Devices: Token Ring devices 

Examples 


1. LANCP> LIST DEVICE/MOPDLL 

Device Listing, permanent database: 

— MOP Downline Load Service Characteristics — 
Device State Access Mode Clients Data Size 


EXAO Enabled Exclusive KnownClientsOnly 1400 bytes 

FXAO Disabled NoExclusive NoKnownClientsOnly 246 bytes 

This command displays MOP downline load information in the LAN 
permanent device database for all known devices. 

2. LANCP> LIST DEVICE/MOPDLL EXAO 

Device Listing, permanent database: 

— MOP Downline Load Service Characteristics — 
Device State Access Mode Clients Data Size 


EXAO Enabled Exclusive KnownClientsOnly 1400 bytes 

This command displays MOP downline load information in the LAN 
permanent device database for device EXAO. 


LIST NODE 


Displays information in the LAN permanent node database, especially MOP 
downline load information. 

Format 

LIST NODE node-name 

Parameter 

node-name 

Specifies the node name. The name can include up to 63 characters associated 
with the node address. If no node name is given, all nodes are displayed. 
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Qualifiers 

/ALL 

Displays data for all nodes in the LAN permanent node database. If you specify a 
node name, all matching nodes are selected; for example, A/ALL selects all nodes 
beginning with A. 

IO\JTPUT=command-file-name 

Creates the specified file and directs output there in the form of a list of DEFINE 
NODE or SET NODE commands. The resulting command file can be used to 
create the LAN node databases. 

Example 


LANCP> LIST NODE 
Node Listing: 

GALAXY (08-00-2B-2C-51-28): 

MOP DLL: Load file: APB.EXE 

Load root: $64$DIA24:<SYS11.> 

Boot type: Alpha satellite 

ZAPNOT (08-00-2B-18-7E-33): 

MOP DLL: Load file: NISCS_LOAD.EXE 

Load root: LAVC$SYSDEVICE:<SYS10.> 

Boot type: VAX satellite 

CALPAL (08-00-2B-08-9F-4C): 

MOP DLL: Load file: READ_ADDR.SYS 

Last file: LAN$DLL:APB_X5WN.SYS 

Boot type: Other 

2 loads requested, 1 volunteered 
1 succeeded, 0 failed 

Last request was for a system image, in MOP V4 format 

Last load initiated 30-OCT-1994 09:11:17 on EXAO for 00:00:06.65 

527665 bytes, 4161 packets, 0 transmit failures 


Unnamed (00-00-00-00-00-00): 


Totals: 

Requests received 2 
Requests volunteered 1 


Successful loads 
Failed loads 
Packets sent 
Packets received 
Bytes sent 
Bytes received 
Last ‘load 


1 

0 

2080 

2081 

523481 

4184 

CALPAL at 30-OCT-1994 09:11:17.29 


This example shows output from a LIST NODE command issued on a local node 
on which there are three nodes defined (GALAXY, ZAPNOT, and CALPAL). 
CALPAL has issued two load requests: 

• The first request is the multicast request from CALPAL that the local node 
volunteered to accept. 

• The second request is the load request sent directly to the local node by 
CALPAL for the actual load data. The elapsed time from the second load 
request to completion of the load was 6.65 seconds. 
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PURGE DEVICE 



Deletes a device from the LAN permanent device database. Requires SYSPRV 
privilege. 

Format 

PURGE DEVICE device-name 

Parameter 

device-name 

Supplies the LAN controller device name. The device name has the form ddcu 
where dd is the device code, c is the controller designation, and u is the unit 
number. LAN devices are specified as the name of the template device which is 
unit 0. For example, the first DE435 Ethernet device is specified as EWAO, the 
second as EWBO. 

For example, you can specify a DEMNA controller as EXA, EXAO, or EXAO:. To 
select all LAN devices, omit the device name and include the /ALL qualifier. 

Qualifier 

/ALL 

Deletes all LAN devices in the LAN permanent device database. If you specify 
a device name, all matching LAN devices are selected, for example: E to select 
all Ethernet devices, F for FDDI, I for Token Ring, EW to select all Ethernet PCI 
Tulip devices. 

Example 

LANCP> PURGE DEVICE/ALL 

This command deletes all devices from the LAN permanent device database. 


PURGE NODE 



Deletes a node from the LAN permanent node database. Requires SYSPRV 
privilege. 

Format 

PURGE NODE node-name 

Parameter 

node-name 

Supplies the name of a node in the LAN permanent node database. 
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Qualifier 

/ALL 

Deletes all LAN nodes in the LAN permanent node database. If you specify a 
node name, all matching nodes are selected; for example, A/ALL deletes all nodes 
whose name begins with A. 

Example 

LANCP> PURGE NODE/ALL 

This command deletes all nodes from the LAN permanent node database. 


SET ACP 


Modifies the operation of the LANACP LAN Server process. Requires SYSPRV 
privilege. 

Format 

SET ACP 

Parameters 

None. 

Qualifiers 

/ECHO 

/NOECHO (default) 

Enables partial tracing of received and transmitted downline load messages (the 
first 32 bytes of the data portion of each message). Note that the last one or 
two MOP messages are displayed in full: the memory load message with cluster 
parameters, and the parameter load with transfer address message, where 
present in the load. 

The data is written to a log file SYS$MANAGER:LAN$m)c/e-raarae.LOG. 

To obtain the entire contents of each message, use the /FULL qualifier. 

SET ACP/ECHO/FULL 

/FULL 

/NOFULL (default) 

When /ECHO is enabled, displays the entire contents of received and transmitted 
downline load messages. 

/OPCOM (default) 

/NOOPCOM 

Enables OPCOM messages from LANACP LAN Server process. 

Messages are generated by the LANACP LAN Server process when a device 
status changes, load requests are received, and loads complete. These messages 
are displayed on the operator’s console and included in the log file written by 
LANACP, SYS$MANAGER:LAN$ACP.LOG. 
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/STOP 

Stops the LANACP process. It can be restarted by reexecuting the 
SYS$STARTUP:LAN$STARTUP command file. 

Example 

LANCP> SET ACP/ECHO/FULL 

This command enables tracing of received and transmitted downline load 
messages. The /FULL qualifier displays the entire contents of received and 
transmitted downline load messages. 


SET DEVICE (parameters) (Alpha only) 


Alpha 


Sets or modifies LAN device parameters. Requires HY_IO privilege. 

Format 

SET DEVICE device-name 

Parameter 

device-name 

Specifies a device to be entered in the LAN volatile device database, or whose 
parameters are to be modified. The device name has the form ddcu where dd is 
the device code, c is the controller designation, and u is the unit number. LAN 
devices are specified as the name of the template device which is unit 0. For 
example, the first DE435 Ethernet device is specified as EWAO, the second as 
EWBO. 

Qualifiers 

/AGING_TIMER=va/ue 

Sets the amount of time in seconds to age source routing cache entries before 
marking them stale. This timer expires when no traffic is sent to or received from 
the remote node in this amount of time. The default value is 60 seconds. 

Increase this value when idle connections bounce between the stale and known 
states. Setting this value too low may cause unnecessary explorer traffic to 
traverse the LAN. 

Devices: Token Ring devices 

/ALL 

Sets data for all LAN devices. If you specify a device name, all matching LAN 
devices are selected, for example: E to select all Ethernet devices, F for FDDI, I 
for Token Ring, EW to select all Ethernet PCI Tulip devices. 

/CACHE_ENTRIES=va/i/e 

Sets the number of entries to reserve for caching source routing address entries. 
The default value is 200 entries. 

If your system directly communicates to a large number of systems, you may 
want to increase this number. 
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Devices: Token Ring devices 

/CONTENDER 
/NOCONTENDER (default) 

Specifies that the device is to participate in the Monitor Contention process when 
it joins the ring. The negated form of the qualifier, /NOCONTENDER, directs the 
device not to challenge the current ring server. 

Devices: Token Ring devices 

/DISCOVERY_TIMER=va/ue 

Sets the number of seconds to wait for a reply from a remote node when 
performing the source routing route discovery process. The default value is 2 
seconds. 

If you have nodes that respond slowly on your extended LAN, you may need to 
increase this number to reduce the amount of explorer traffic that traverses your 
LAN. 

Devices: Token Ring devices 

/EARLY (default) 

/NOEARLY 

Enables Early Token Release on the device. The negated form of the qualifier, 
/NOEARLY, disables Early Token Release. 

Devices: Token Ring devices operating on 16-megabit rings 

/FULL_DUPLEX 
/NOFULL_DUPLEX (default) 

Enables full-duplex operation of a LAN device. Before full-duplex operation 
results from the use of this qualifier, additional device or network hardware 
setup may be required. Some devices may be enabled for full-duplex operation by 
default. Some devices may not allow the setting to be changed. 

The negated form of the qualifier, /NOFULL_DUPLEX, disallows full-duplex 
operation regardless of the hardware configuration. 

Devices: Devices that support full-duplex operation 

/MAP=(MULTICAST_ADDRESS=address, FUNCTIONAL_ADDRESS=address) 
/NOMAP=(MULTICAST_ADDRESS=address) 

Maps a standard multicast address to a functional address. Token ring devices 
do not support IEEE 802 standard globally defined group addresses. They do 
support functional addresses. A functional address is a locally administered 
group address that has 31 possible values. Each functional address sets one bit 
in the 3rd through 6th byte of the address and bytes 1 and 2 are 03-00 (C0:00 in 
bit reversed format). 

The negated form of the qualifier, /NOMAP=(MULTICAST_ADDRESS=ac/dress), 
clears the mapping established for the specified address. 

Specify the functional address as follows: 

• The MULTICAST_ADDRESS argument requires a standard 6-byte multicast 
address. 

• The FUNCTIONAL_ADDRESS argument requires only the last 4 bytes of the 
functional address (the preceding 03-00 bytes are automatically prefixed). 
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• The address variable, given as hexadecimal byte characters separated by 
hyphens, specifies the canonical form of the address. Use a colon as the 
separator character to indicate the bit-reversed form of the address. 

For example, to map the multicast address CB-00-01-02-03-04 to the functional 
address 03-00-00-80-00-00 on the Token Ring device IRA0, enter the following 
command: 

SET DEVICE IRA0/MAP=(MULTI=CB-00-01-02-03-04,FUNCT=00:01:00:00) 

For the default address mapping, see Table 12—2 or issue the command SHOW 
DEVICE/MAP device-name. 


Table 12-2 Default Functional Address Mapping for Token Ring Devices 


Multicast Address 

Functional Address 

Description 

09-00-2B-00-00-04 

03-00-00-00-02-00 

ISO ALL ES 

09-00-2B-00-00-05 

03-00-00-00-01-00 

ISO ALL IS 

CF-00-00-00-00-00 

03-00-00-08-00-00 

Loopback Assistant 

AB-00-00-01-00-00 

03-00-02-00-00-00 

DNA MOP Dump/Load 

AB-00-00-02-00-00 

03-00-04-00-00-00 

DNA MOP Remote Console 

AB-00-00-03-00-00 

03-00-08-00-00-00 

DNA LI Routers 

09-00-2B-02-00-00 

03-00-08-00-00-00 

DNA L2 Routers 

09-00-2B-02-01-0A 

03-00-08-00-00-00 

DNA Phase IV Primary Router 

AB-00-00-04-00-00 

03-00-10-00-00-00 

DNA Endnodes 

09-00-2B-02-01-0B 

03-00-10-00-00-00 

DNA Phase IV Prime Unknown 
Destination 

09-00-2B-00-00-07 

03-00-20-00-00-00 

PCSA NETBIOS Emulation 

09-00-2B-00-00-0F 

03-00-40-00-00-00 

LAT Service Advertisement 

09-00-2B-02-01-04 

03-00-80-00-00-00 

LAT Service Solicit 

09-00-2B-02-01-07 

03-00-00-02-00-00 

LAT Xwindown Service Solicit 

09-00-2B-04-00-00 

03-00-00-04-00-00 

LAST 

09-00-2B-02-01-00 

03-00-00-00-08-00 

DNA Name Service Advertisement 

09-00-2B-02-01-01 

03-00-00-00-10-00 

DNA Name Service Solicit 

09-00-2B-02-01-02 

03-00-00-00-20-00 

DNA Time Service 

03-00-00-00-00-01 

03-00-00-00-00-01 

NETBUI Emulation 

03-00-02-00-00-00 

03-00-02-00-00-00 

RIPL 


Devices: Token Ring devices 

/MAX_BUFFERS= value 

Sets the maximum number of receive buffers to be allocated and used by the LAN 
driver for the LAN device. The value must be within the range 4 to 32. The value 
cannot be less than the minimum number of receive buffers. The default value is 
32. 

Devices: all LAN devices 
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/MEDIA=i value 


For Token Ring devices: 

Selects the type of cable media used to connect the adapter to the Token Ring 
Media Access Unit (MAU) for devices that do not automatically detect this. 
Acceptable values for this are either UTP (unshielded twisted pair) or STP 
(shielded twisted pair). The default value is STP. 

For Ethernet devices: 


Selects the cable connection. Normally, the selection is made during device 
initialization using a limited autosensing algorithm that selects twisted pair 
but fails over to AUI (Attachment Unit Interface) if twisted pair does not 
appear to be functional. Thereafter, a cabling change would require a reboot 

of the system to take effect. This command allows you to change the selection 
without rebooting. 


Acceptable values are AUI (10Base2, 10Base5), TWISTEDPAIR (lOBaseT) 
and AUTOSENSE (reperform the limited autosense algorithm). The default 
value is AUTOSENSE. 


Some devices, such as the DE435, require a jumper change on the Ethernet 
card to switch between 10Base2 and 10Base5 (thinwire and thickwire) Other 
devices, such as the DE434, DE436, and DE500, have only twisted pair 
connections. 


Devices: Any LAN device that has software-settable media selection 

/MIN_BUFFERS=va/ue 

This qualifier sets the minimum number of receive buffers to be allocated and 

?? d oo y l! LAN driver f ° r the LAN device - The v alue must be within the range 
4 to 32. The value cannot exceed the maximum number of receive buffers The 
default value is 32. 

Devices: all LAN devices 


/SOURCE_ROUTING (default) 

/NOSOURCE_ROUTING 

Enables source routing on the Token Ring device. If you only have one ring in 
your LAN or you use transparent bridging, use the /NOSOURCE_ROUTING 
qualifier to turn off source routing. 

Devices: Token Ring devices 

/SPEED= value 

Sets the speed of the LAN. 

For Token Ring, valid values are either 4 or 16, indicating 4 megabits per second 
° r megabits per second. The default value for Token Ring is 16, unless the 
LAN adapter supports a non-volatile mechanism for setting this parameter (as 
does the DEC Token Ring Controller 700). 

For Ethernet, valid values are either 10 or 100, which selects the 10 megabits 
per second Ethernet port or the 100 megabits per second Fast Ethernet port. The 
default for Ethernet is to sense automatically which type of port is connected and 
select the appropriate speed. 

Devices: Token Ring devices and the DE500 Ethernet/FastEthernet device 
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/SR ENTRY=(LAN_ADDRESS=address, R\=routing-information) 
/NOSR_ENTRY=(LAN_ADDRESS=address) _ , , ,, 

Statically defines a specific source-routed route for a specific node. The aetaut 
value is no routes specified. This caching remains valid while used or until the 
aging timer expires. 

Use this qualifier only as a last resort when isolating communication failures on 
extended LAN topologies. 

The negated form of the qualifier, /NOSR_ENTRY=(LAN_ADDRESS=ac£dress), 
clears the previously defined static source routed route. 

The address is a standard 6-byte LAN address (given as hexadecimal byte 
characters separated by hyphens), which specifies the canonical form of the 
address. Using a colon as the separator character indicates the bit-reversed form 

of the address. 

The routing-information is the source routing field, specified as a series of 
two-byte hexadecimal characters (each byte separated by a hyphen). The field 
consists of a two-byte routing control field followed by up to 14 two-byte segment 
identifiers, each containing the ring number and the bridge number used in the 

hop. 

Devices: Token Ring devices 


Examples 

1. LANCP> SET DEVICE/CONTENDER/MEDIA=UTP/NOEARLY/SOURCE ICAO 

Enables monitor contention, UTP cable media, source routing and disables 
early token release for Token Ring device ICAO. 

2. LANCP> SET DEVICE/MEDIA=TWI EWBO 

Sets the media type to twisted pair for the second Tulip Ethernet device, 
EWB0.4 


SET DEVICE (volatile device database) 


Enters a device into the LAN volatile device database or modifies an existing 
entry. Requires SYSPRV privilege. 

Format 

SET DEVICE device-name 

Parameter 

device-name , , , 

Specifies a device to be entered in the LAN volatile device database or an entry to 

be modified. 
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Qualifiers 

/ALL 

Defines data for all LAN devices in the LAN volatile device database. If you 
specify a device name, all matching LAN devices are selected, for example: E 
to select all Ethernet devices, F for FDDI, I for Token Ring, EW to select all 
Ethernet PCI Tulip devices. 

/MOPDLL=(enable-option, exclusive-option, size-option, knownclientsonly- 
option) 

Provides the MOP downline load service settings for the device. 

Note that defaults apply to creation of an entry in the device database. If an 
existing entry is being modified, fields not specified remain unchanged. 

You can specify the following keywords with this qualifier: 

• enable-option 

ENABLE 

DISABLE (default) 

Specify ENABLE or DISABLE to indicate that MOP downline load service 
should be enabled or disabled for the device. 

• exclusive-option 

EXCLUSIVE 
NOEXCLUSIVE (default) 

Specify EXCLUSIVE to indicate that no other provider of MOP downline load 
service is allowed on the specified LAN device at the same time as LANACP. 
Specify NOEXCLUSIVE to indicate that the LAN MOP downline load service 
can coexist with other implementations (in particular, the DECnet Phase IV 
implementation that operates the MOP protocol in shared mode). 

• knovonclientsonly-option 

KNOWNCLIENTSONLY 
NOKNOWNCLIENTSONLY (default) 

Specify KNOWNCLIENTSONLY to indicate that MOP downline load 
requests should be serviced only for clients defined in the LAN volatile 
node database. When NOKNOWNCLIENTSONLY is selected, LANACP 
searches the LAN$DLL directory for any images requested by clients that are 
not defined in the LAN volatile node database. 

• size-option 

SIZE =value 

Use SIZE =value to specify the size in bytes of the file data portion of each 
downline load message. The permitted range is 246 to 1482 bytes. The 
default value is 246 bytes, which should allow any client to load properly. 
Note that some clients may not support the larger size. 

The recommended size for better load performance and less server overhead is 
the largest size that results in successful loads of all clients. The 1482 value 
is derived from the maximum packet size for CSMA/CD (Ethernet) of 1518 
bytes less the 802e header and CRC (26 bytes) and MOP protocol overhead 
(10 bytes). 

You can override the size on a per-node basis. See DEFINE NODE and SET 
NODE for details. 
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/PERMANENT_DATABASE 

Updates the device entries in the LAN volatile device database with any data 
currently set in the permanent database. This allows you to update the volatile 
database after changing data in the permanent database, rather than repeating 
the commands for each updated entry to apply the changes to the volatile 
database. 

/UPDATE 

Adds LAN devices that are not currently in the LAN volatile device database 
to that database. The initial entry for the device uses default values for all 
parameters. To update the volatile database with current information from the 
permanent database, use the SET DEVICE command with the /PERMANENT_ 
DATABASE qualifier. You can combine the /UPDATE and /PERMANENT. 
DATABASE qualifiers in a single SET DEVICE command. 

Examples 


1. LANCP> SET DEVICE EXAO/M0PDLL=ENABLE 

Enables MOP downline load service for device EXAO, leaving the remaining 
MOPDLL parameters unchanged. 

2. LANCP> SET DEVICE EXAO/MOPDLL=(ENABLE,EXCLUSIVE,SIZE=1482) 

Enables MOP downline load service for device EXAO, in exclusive mode 
with the data transfer size of 1482 bytes, leaving the remaining MOPDLL 
parameters unchanged. 

3. LANCP> SET DEVICE EXAO/MOPDLL=(ENABLE,NOEXCLUSIVE) 

LANCP> SET DEVICE FXAO/MOPDLL=(ENABLE,EXCL,KNOWN) 

These commands enable LANACP MOP downline load service for: 

• LAN device EXAO in nonexclusive mode 

• LAN device FXBO in exclusive mode for only known clients 


SET NODE 


Enters a node into the LAN volatile node database or modifies an existing entry. 
Requires SYSPRV privilege. 


Format 

SET NODE node-name 

Parameter 

node-name 

Supplies the name of a node to be added to the LAN volatile node database or 
an entry to be modified. Typically, the node name is the same as that given in 
the system parameter SCSNODE, but it does not need to be. The node name is 
limited to 63 characters in length. 
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Qualifiers 


/ADDRESS =node-address 
/NOADDRESS (default) 

Associates a LAN address with the node name. Specify the address as 6 bytes 
in hexadecimal notation, separated by hyphens. The address does not have to be 
unique (as might be the case when the address is not known, so a nonexistent 
address is specified). 

If multiple node addresses are to be associated with a node name, each 
combination may be given as a node name with an extension, for example, 
VAXSYS.EXA for the EXA device on node VAXSYS, or VAXSYS_1 for the first 
LAN device on node VAXSYS. 

If you do not specify the /ADDRESS qualifier, the setting remains unchanged. 
The /NOADDRESS qualifier clears the field. 

/ALL 

Defines data for all nodes in the LAN volatile node database. If you specify a 
node name, all matching nodes are selected; for example, A/ALL selects all nodes 
beginning with A. 

/B OOT_T Y PE=boot-option 
/NOBOOT_TYPE 

Indicates the type of processing required for downline load requests. You can 
specify one of the following keywords with this qualifier: 

• VAX_SATELLITE—a VAX satellite cluster boot 

• ALPHA_SATELLITE—an Alpha satellite cluster boot 

• OTHER—the specified image; noncluster satellite loads that do not require 
additional data 

The distinction is necessary, because VMScluster satellite loads require additional 
cluster-related data be appended to the load image given by the /FILE qualifier. 
The default value is OTHER. 

If you do not specify the /BOOT_TYPE qualifier, the setting remains unchanged. 
The /NOBOOT_TYPE qualifier clears the field. 

fF\LE=file-spec 
/NOFILE 

Supplies the file name of a boot file to be used when the downline load request 
does not include a file name (for example, VMScluster satellite booting). The file 
specification is limited to 127 characters. 

If no file name is specified, VMScluster satellite loads default to APB.EXE where 
the boot type is set to ALPHA and NISCS_LOAD.EXE where the boot type is set 
to VAX. 

If you do not specify the /FILE qualifier, the setting remains unchanged. The 
/NOFILE qualifier clears the field. 

/PERMANENT_DATABASE 

Updates the node entries in the LAN volatile node database with any data 
currently set in the permanent database. This allows you to update the volatile 
database after changing data in the permanent database, rather than repeating 
the commands for each updated entry to apply the changes to the volatile 
database. 
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/R OOT= directory-specification 
/NOROOT 

Supplies the directory specification to be associated with the file name. For 
cluster satellite service, the /ROOT qualifier specifies the satellite root directory. 
For noncluster service, this qualifier specifies the location of the file. If the file 
specification or the file name given in the boot request includes the directory 
name, this qualifier is ignored. The directory specification is limited to 127 
characters. 

If you do not specify the /ROOT qualifier, the setting remains unchanged. The 
/NOROOT qualifier clears the field. 

IS\ZE= value 
/NOSIZE 

Specifies the size in bytes of the file data portion of each downline load message. 
The default is the load data size specified for the device. The permitted range is 
246 to 1482 bytes. Use a larger size for better load performance and less server 
overhead. 

If you do not specify the /SIZE qualifier, the setting remains unchanged. The 
/NOSIZE qualifier clears the setting. 

/V3 

/NOV3 

Indicates that only MOP Version 3 formatted messages are to be used for 
downline load purposes, regardless of the requested format. This allows systems 
to load that have a problem with MOP Version 4 booting. This qualifier causes 
the requesting node to fail over from MOP Version 4 to MOP Version 3 when no 
response has been made to a MOP Version 4 load request. 

If you do not specify the /V3 qualifier, the setting remains unchanged. The /NOV3 
qualifier clears the setting. 

Examples 

1. LMCP> SET NODE VAXSYS/ADDRESS=08-00-2B-ll-22-33 - 

/FILE=APB.EXE - 
/ROOT=$64$DIA14:<SYS10.> - 
/BOOT_TYPE=ALPHA_SATELLITE 

T his command sets up node VAXSYS for booting as an Alpha satellite into the 
VMScluster. 

The APB.EXE file is actually located on $64$DIA14: 
<SYS10.SYSCOMMON.SYSEXE>. Note that the <SYSCOMMON.SYSEXE> 
is supplied by the LANACP LAN Server process and is not included in the 
root definition. 

2. LANCP> SET NODE VAXSYS/ADDRESS=08-00-2B-ll-22-33 - 

/FILE=NISCS_LOAD.EXE - 
/ROOT=$64$DIA14:<SYS10.> - 
/BOOT_TYPE=VAX_SATELLITE 

This command sets up node VAXSYS for booting as a VAX satellite into the 
VMScluster. 

The NISCS_LOAD.EXE file is actually located on $64$DIA14: 
<SYS10.SYSCOMMON.SYSLIB>. The <SYSCOMMON.SYSLIB> is supplied 
by the LANACP LAN Server process and is not included in the root definition. 
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LANCP 
SET NODE 


3. LANCP> SET NODE VAXSYS/ADDRESS=08-00-2B-ll-22-33/NOROOT 

This command changes the LAN address associated with node VAXSYS and 
clears the current root specification. 

4. SET NODE CALPAL/ADDRESS=08-00-2B-ll-22-33/FILE=APB_061.EXE 

This command sets up node CALPAL for booting an InfoServer image. It 
defines the file that should be loaded when a load request without file name 
is received from node CALPAL. 

Because the file does not include a directory specification, the logical 
name LAN$DLL defines where to locate the file. You could give directory 
specification using the file name or by using the /ROOT qualifier. 

Note that specifying the file name explicitly in the boot command overrides 
the file name specified in the node database entry. 


SHOW CONFIGURATION 


Format 

Parameters 

Qualifiers 

Example 


Displays a list of LAN devices and characteristics on the system. 


SHOW CONFIGURATION 


None. 


None. 


LANCP> SHOW CONFIGURATION 
LAN Configuration: 


Device 

Medium 

Default LAN Address 

Version 

EWAO 

EWBO 

IRAQ 

CSMA/CD 
CSMA/CD 
Token Ring 

08-00-2B-E4-00-BF 

08-00-2B-92-A4-OD 

00-00-93-58-5D-32 

02000023 

02000023 

20000223 


This example shows the output from a SHOW CONFIGURATION command that 
was entered on a node that has three LAN devices, two DE435s, and a DETRA. 

The version is the device-specific representation of the actual (hardware or 
firmware) version. In this example, for two devices on the PCI bus, the actual 
version is in the low byte (2.3 for the DE435 adapters). A device that does not 
have a readable version is shown as version zero. 

Consult your device-specific documentation to correlate the version returned with 
a particular hardware or firmware implementation of the device. 
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LANCP 

SHOW DEVICE 


SHOW DEVICE 


Displays information in the volatile device database. If the LANACP process is 
not running, displays a list of current LAN devices. 

Format 

SHOW DEVICE device-name 

Parameter 

device-name 

Supplies the LAN controller device name. The device name has the form ddcu 
where dd is the device code, c is the controller designation, and u is the unit 
number. LAN devices are specified as the name of the template device which is 
unit 0. For example, the first DE435 Ethernet device is specified as EWAO, the 
second as EWBO. 

For example, you can specify a DEMNA controller as EXA, EXAO, or EXAO:. 
This refers to the LAN template device, for which is maintained most of the 
device parameters and counters. Also, the device name can refer to a device unit 
representing an actual user or protocol. For example, the cluster protocol can 
be started on a device as EWA1. You can specify specific device units to view 
unit-specific parameter information. 

If you do not specify a device name, all devices are displayed. 

If you specify a device name, all matching LAN devices are displayed, for 
example: E to select all Ethernet devices, F for FDDI, I for Token Ring, EW to 
select all Ethernet PCI Tulip devices. 

_ Note --- 

If you do not specify a qualifier, the utility displays the matching devices 
without additional information. 


Qualifiers 

/COUNTERS 

Displays device counters. 

Devices: All LAN devices; template devices only 

/MAP 

Displays the current configuration of the functional address mapping table. 
Devices: Token Ring devices; template devices only 

/MOPDLL 

Displays LAN volatile device database information related to MOP downline load 
for the device. 

/PARAMETERS 

Displays status and related information about the device. 
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LANCP 
SHOW DEVICE 


Examples 


Devices: All LAN devices 

/REVISION 

Displays the current firmware revision of the device, if available or applicable. 
Not all LAN devices return revision information. LAN devices that do not have a 
revision display a revision of zero. 

Devices: LAN devices; template devices only 

/SR_ENTRY 

Displays the contents of the current source routing cache table. 

Devices: Token Ring devices; template devices only 


1. LANCP> SHOW DEVICE/COUNTERS EXAO 


Device Counters EXAO: 

Value Counter 


259225 

5890496 

4801439 

131074 

764348985 

543019961 

3 

1533610 

115568 

122578 

86000 

189039 

198120720 

13232578 

7274529 

0 

0 

0 

0 


Seconds since last zeroed 
Data blocks received 
Multicast blocks received 
Receive failure 
Bytes received 
Multicast bytes received 
Data overrun 
Data blocks sent 
Multicast packets transmitted 
Blocks sent, multiple collisions 
Blocks sent, single collision 
Blocks sent, initially deferred 
Bytes sent 

Multicast bytes transmitted 
Send failure 

Collision detect check failure 
Unrecognized frame destination 
System buffer unavailable 
User buffer unavailable 


This command displays counters for Ethernet device EXAO. 


2. LANCP> SHOW DEVICE/MAP ICAO 
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LANCP 

SHOW DEVICE 


Multicast to Functional Address Mapping ICAO: 


Multicast 

; address 

Functional Address 

Bit-Reversed 


09- 

-00- 

-2B- 

-00- 

-00- 

•04 

03- 

-00- 

■00- 

■00- 

■02- 

■00 

CO: 

00: 

00: 

00: 

40: 

00 

09- 

-00- 

-2B- 

•00- 

-00- 

■05 

03- 

-00- 

-00- 

■00- 

■01- 

■00 

CO: 

00: 

00: 

00: 

80: 

00 

CF- 

-00- 

-00- 

-00- 

-00- 

■00 

03- 

-00- 

-00- 

-08- 

■00- 

■00 

CO: 

00: 

00: 

: 10: 

00: 

00 

AB- 

-00- 

-00- 

-01- 

-00- 

■00 

03- 

-00- 

-02- 

-00- 

-00- 

■00 

CO: 

00: 

40: 

: 00: 

: 00: 

00 

AB- 

-00- 

-00- 

-02- 

-00- 

-00 

03- 

-00- 

-04- 

-00- 

-00- 

-00 

CO: 

: 00: 

20: 

: 00: 

: 00: 

00 

AB- 

-00- 

-00- 

-03- 

-00- 

-00 

03- 

-00- 

-08- 

-00- 

-00- 

-00 

CO: 

: 00: 

: 10: 

: 00: 

: 00: 

00 

09- 

-00- 

-2B- 

-02- 

-00- 

-00 

03- 

-00- 

-08- 

-00- 

-00- 

-00 

CO: 

: 00: 

: 10: 

: 00: 

: 00: 

00 

09- 

-00- 

-2B- 

-02- 

-01- 

-0A 

03- 

-00- 

-08- 

-00- 

-00- 

-00 

CO: 

: 00: 

: 10: 

: 00: 

: 00: 

: 00 

AB- 

-00- 

-00- 

-04- 

-00- 

-00 

03- 

-00- 

-10- 

-00- 

-00- 

-00 

CO: 

: 00: 

: 08: 

: 00: 

: 00: 

: 00 

09- 

-00- 

-2B- 

-02- 

-01- 

-0B 

03- 

-00- 

-10- 

-00- 

-00- 

-00 

CO: 

: 00: 

: 08: 

: 00: 

: 00: 

: 00 

09- 

-00- 

-2B- 

-00- 

-00- 

-07 

03- 

-00- 

-20- 

-00- 

-00- 

-00 

CO: 

: 00: 

: 04: 

: 00: 

: 00: 

: 00 

09- 

-00- 

-2B- 

-00- 

-00- 

-OF 

03- 

-00- 

-40- 

-00- 

-00- 

-00 

CO: 

: 00: 

: 02: 

: 00: 

: 00: 

: 00 

09- 

-00- 

-2B- 

-02- 

-01- 

-04 

03- 

-00- 

-80- 

-00- 

-00- 

-00 

CO: 

: 00: 

: 01: 

: 00: 

: 00: 

: 00 

09- 

-00- 

-2B- 

-02- 

-01- 

-07 

03- 

-00- 

-00- 

-02- 

-00- 

-00 

CO: 

: 00: 

: 00 

: 40 

: 00: 

: 00 

09- 

-00- 

-2B- 

-04- 

-00- 

-00 

03- 

-00- 

-00- 

-04- 

-00- 

-00 

CO: 

: 00: 

: 00 

: 20 

: 00: 

: 00 

09- 

-00- 

-2B- 

-02- 

-01- 

-00 

03- 

-00- 

-00- 

-00- 

-08- 

-00 

CO 

: 00 

: 00 

: 00 

: 10: 

: 00 

09- 

-00- 

-2B- 

-02- 

-01- 

-01 

03- 

-00- 

-00- 

-00- 

-10- 

-00 

CO 

: 00 

: 00 

: 00 

: 08 

: 00 

09- 

-00- 

-2B- 

-02- 

-01- 

-02 

03- 

-00- 

-00- 

-00- 

-20- 

-00 

CO 

: 00 

: 00 

: 00 

: 04 

: 00 

03- 

-00- 

-00- 

-00- 

-00- 

-01 

03- 

-00- 

-00- 

-00- 

-00- 

-01 

CO 

: 00 

: 00 

: 00 

: 00 

: 80 

03- 

-00- 

-02- 

-00- 

-00- 

-00 

03- 

-00- 

-02- 

-00- 

-00- 

-00 

CO 

: 00 

: 40 

: 00 

: 00 

: 00 


This command displays mapping information for Token Ring device ICAO. 

3. LANCP> SHOW DEVICE/MOPDLL 

Device Listing, volatile database: 

— MOP Downline Load Service Characteristics — 

Device State Access Mode Clients Data Size 


EXAO Enabled Exclusive KnownClientsOnly 1400 bytes 

FXAO Disabled NoExclusive NoKnownClientsOnly 246 bytes 

This command displays MOP downline load information in the LAN volatile 
device database for all known devices. 

4. LANCP> SHOW DEVICE/MOPDLL EXAO 

Device Listing, volatile database: 

— MOP Downline Load Service Characteristics — 

Device State Access Mode Clients Data Size 


EXAO Enabled Exclusive KnownClientsOnly 1400 bytes 

This command displays MOP downline load information in the LAN volatile 
device database for device EXAO. 
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LANCP 
SHOW DEVICE 


5. LANCP> SHOW DEVICE/PARAMETERS IRAO 

Device Parameters IRAO: 

Value Parameter 


Normal 
External 
00-00-93-58-5D-32 
Token Ring 
Enabled 
No 
No 
16 

16 Mbps 
STP 
Enabled 
Disabled 
200 
2 

60 

Enabled 

3 

AA-00-04-00-92-FF 
0 


Controller mode 
Internal loopback mode 
Hardware LAN address 
Communication medium 
Functional address mode 
Full duplex enable 
Full duplex operational 
Line speed (megabits/second) 
Ring speed 
Line media 
Early token release 
Monitor contender 
SR cache entries 
SR discovery timer 
SR Aging Timer 
Source routing 
Authorized access priority 
Upstream neighbor 
Ring number 


This command displays status and parameters information for Token ring 
device IRAO. 


6. LANCP> SHOW DEVICE/REVISION FXA0 
Device revision FXA0: 05140823 


This command displays revision information for FDDI device FXAO. 

7. LANCP> SHOW DEVICE/SR_ENTRY ICAO 

Source Routing Cache Table ICAO: 

LAN address State XmtTmo RcvTmo StaleTmo DiscvTmo 

AA-00-04-00-92-FF LOCAL 00000028 00000028 00000245 00000000 

This command displays source routing entry information for Token Ring 
device ICAO. 


SHOW LOG 


Displays recent downline load activity (the last 2048 bytes of log data written to 
the log file SYS$MANAGER:LAN$ACP.LOG). 

Format 

SHOW LOG 


Parameters 

None. 
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LANCP 
SHOW LOG 


Qualifiers 

None. 

Example 


LANCP> SHOW LOG 

SYS$MANAGER:LAN$ACP.LOG latest contents: 

17-MAR-1995 07:29:51.71 Volunteered to load request on EXAO from HELENA 

Requested file: LAVC$SYSDEVICE:<SYS1A.>[SYSCOMMON.SYSLIBlNISCS_LOAD.EXE 
17-MAR-1995 07:29:53.00 Load succeeded for HELENA on EXAO 
MOP V3 format, System image, 

LAVC$SYSDEVICE:<SYS1A.>[SYSCOMMON.SYSLIB]NISCS_LOAD.EXE 
Packets: 84 sent, 84 received 

Bytes: 121492 sent, 168 received, 120988 loaded 

Elapsed time: 00:00:01.09, 110998 bytes/second 
17-MAR-1995 07:29:53.60 Could not respond to load request on EXAO from AJAX, 
file not found 

Requested file: LAN$DLL:READ_ADDR.SYS 

17-MAR-1995 07:29:54.46 Could not respond to load request on EXAO from AJAX, 
file not found 

Requested file: LAN$DLL:READ_ADDR.SYS 
17-MAR-1995 07:29:57.36 Volunteered to load request on EXAO from HELENA 

Requested file: LAVC$SYSDEVICE:<SYS1A.>[SYSCOMMON.SYSLIB]NISCS_LOAD.EXE 
17-MAR-1995 07:29:58.49 Volunteered to load request on EXAO from AJAX 

Requested file: LAVC$SYSDEVICE:<SYS10.>[SYSCOMMON.SYSLIB]NISCS_LOAD.EXE 
17-MAR-1995 07:29:59.49 Load succeeded for HELENA on EXAO 
MOP V3 format, System image, 

LAVC$SYSDEVICE:<SYS1A.>[SYSCOMMON.SYSLIB]NISCS_LOAD.EXE 

Packets: 84 sent, 84 received 

Bytes: 121492 sent, 168 received, 120988 loaded 

Elapsed time: 00:00:01.73, 69935 bytes/second 
17-MAR-1995 07:30:03.66 Volunteered to load request on EXAO from AJAX 
Requested file: LAN$DLL:ONE.SYS 
17-MAR-1995 07:30:04.05 Load succeeded for AJAX on EXAO 
MOP V3 format, System image, LAN$DLL:ONE.SYS 
Packets: 9 sent, 9 received 

Bytes: 11354 sent, 18 received, 11300 loaded 

Elapsed time: 00:00:00.04, 282500 bytes/second 
17-MAR-1995 07:30:04.79 Volunteered to load request on EXAO from AJAX 
Requested file: LAN$DLL:ONE.SYS 
17-MAR-1995 07:30:05.18 Load succeeded for AJAX on EXAO 
MOP V3 format, System image, LAN$DLL:ONE.SYS 
Packets: 9 sent, 9 received 
Bytes: 11354 sent, 18 received, 11300 loaded 

Elapsed time: 00:00:00.04, 282500 bytes/second 


This command displays the last 2048 bytes of log data written to the log file 
SYS$MANAGER:LAN$ACP.LOG. 
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LANCP 
SHOW MOPDLL 


SHOW MOPDLL 


Displays the current state of MOP downline load services for the system, 
including devices for which MOP loading is enabled and counters information. 

Format 

SHOW MOPDLL 

Parameters 

None. 

Qualifiers 

None. 

Example 

SHOW MOPDLL 

LAN MOP DLL Status: 

EXA enabled in exclusive mode for known nodes only, 
data size 1482 bytes 
FXA disabled 

#Loads Packets Bytes Last load time Last loaded 

EXA 5 1675 4400620 23-SEP-1994 10:27.51 GALAXY 

FXA 0 0 0 

On this node, there are two LAN devices, EXA (DEMNA) and FXA (DEMFA). 
MOP downline load service is enabled on EXA in exclusive mode. 

Requests are answered only for nodes that are defined in the LANACP node 
database. The image data size in the load messages is 1482 bytes. There have 
been five downline loads, the last one occurring on node GALAXY at 10:27. 
Finally, there are no recorded downline loads for FXA, which is currently disabled 
for downline load service. 


SHOW NODE 


Format 


Displays information in the LAN volatile node database. 


SHOW NODE node-name 
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LANCP 
SHOW NODE 


Parameter 

node-name 

Specifies the name of a node in the LAN volatile node database. The name can 
include up to 63 characters associated with the node address. If you do not 
specify a node name, all nodes are displayed. 

Qualifiers 

/ALL 

Displays information for all nodes in the LAN volatile node database. If you 
specify a node name, all matching nodes are selected; for example, A/ALL selects 
all nodes beginning with A. 

IOVTPUT=command-file-name 

Creates the specified file and directs output there in the form of a list of DEFINE 
NODE or SET NODE commands. The resulting command file can be used to 
create the LAN node databases. 

/TOTAL 

Display counter totals only, for the nodes selected. 


Examples 


1. LANCP> SHOW NODE 
Node Listing: 

GALAXY (08-00-2B-2C-51-28): 

MOP DLL: Load file: APB.EXE 

Load root: $64$DIA24:<SYS11.> 

Boot type: Alpha satellite 

ZAPNOT (08-00-2B-18-7E-33): 

MOP DLL: Load file: NISCS_LOAD.EXE 

Load root: LAVC$SYSDEVICE:<SYS10.> 

Boot type: VAX satellite 

CALPAL (08-00-2B-08-9F-4C): 

MOP DLL: Load file: READ_ADDR.SYS 

Last file: LAN$DLL:APB_X5WN.SYS 
Boot type: Other 

2 loads requested, 1 volunteered 
1 succeeded, 0 failed 

Last request was for a system image, in MOP V4 format 

Last load initiated 30-OCT-1994 09:11:17 on EXAO for 00:00:06.65 

527665 bytes, 4161 packets, 0 transmit failures 

Unnamed (00-00-00-00-00-00) : 


Totals: 

Requests received 2 
Requests volunteered 1 


Successful loads 
Failed loads 
Packets sent 
Packets received 
Bytes sent 
Bytes received 
Last load 


1 

0 

2080 

2081 

523481 

4184 

CALPAL at 30-OCT-1994 09:11:17.29 
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LANCP 
SHOW NODE 


This example shows output from a command issued on a local node on which 
there are three nodes defined (GALAXY, ZAPNOT, and CALPAL). G AT.P AT, 
has issued two load requests: 

• The first request is the multicast request from CALPAL that the local 
node volunteered to accept. 

• The second request is the load request sent directly to the local node by 
CALPAL for the actual load data. The elapsed time from the second load 
request to completion of the load was 6.65 seconds. 

2. LANCP> SHOW NODE VAXSYS 

Displays node characteristics and counters information from the LAN volatile 
node database for node VAXSYS. 

3. LANCP> SHOW NODE/ALL VAX 

Displays node characteristics and counters information from the LAN volatile 
node database for all nodes whose name begins with VAX. 

4. LANCP> SHOW NODE/ALL 

Displays node characteristics and counters information from the LAN volatile 
node database for all nodes. 

5. LANCP> SHOW NODE/ALL/OUTPUT=TMP.INI 

Writes a list of all nodes to the file TMP.INI. 


SPAWN 

Creates a subprocess of the current process. The SPAWN command copies the 
context of the subprocess from the current process. 

Format 

SPAWN [command-string] 

Parameter 

command-string 

A string of commands to be executed in the context of the created subprocess. 
After the command string is executed, control returns to LANCP. 

Qualifiers 

None. 
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LANCP 

SPAWN 


Example 

LANCP> SPAWN 

$ MC LANCP 

LANCP> DEFINE NODE BOOM/ROOT=LAVC$SYSDEVICE:<SYS22.> 

LANCP> SPAWN SEARCH LAVC$SYSDEVICE:[*.SYSEXE]MOD*.DAT BOOM 

****************************** 

LAVC$SYSDEVICE:[SYS1A.SYSEXE]MODPARAMS.DAT;1 

SCSNODE="BOOM 

LANCP> DEFINE NODE B00M/R00T=LAVC$SYSDEVICE:<SYS1A.> 

In this example, you are enter the node information for a node, but are unsure of 
the root, so you spawn to search MODPARAMS.DAT for the node name and then 
correct the root. 


TRIGGER NODE 



Issues a request to reboot to a remote node. 

Rather than specify the format to send MOP Version 3 or 4, the LANCP utility 
sends one message in each format to the target node. 

Format 

TRIGGER NODE node-specification 

Parameter 

node-specification 

Supplies either the node name or the node address of the target node. If you 
supply the node name, the node address is obtained by looking up the node 
name in the LAN volatile node database. If you supply the node address, the 
corresponding node need not be defined in the LAN volatile node database. The 
canonical form of the address consists of 6 hexadecimal byte characters separated 
by hyphens. Use a colon as the separator character to indicate the bit-reversed 
form of the address. 

Qualifiers 

IDE\l\CE-device-name 

Specifies the LAN controller device name to be used for sending the trigger boot 
messages. For example, you can specify a DEMNA controller as EXA, EXAO or 
EXAO:. 

/PASSWORDS 6hexdigits 

Supplies the password to be used when the connection is initiated, in hexadecimal 
(for example, /PASSWORD=0123456789ABCDEF). The default password is zero. 
You can omit leading zeros. 
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LANCP 
TRIGGER NODE 


Examples 


1. TRIGGER NODE GALAXY/DEVTCE=EWAO 

This command sends MOP trigger boot messages to node GALAXY us ing 
Ethernet device EWAO. 

2. TRIGGER NODE 08-00-2B-ll-22-33/DEVICE=EWA0/PASSWORD=0123456789AB 

This command sends MOP trigger boot messages to the given node address 
using the Ethernet device EWAO, with indicated password. 


UPDATE DEVICE (Alpha only) 


Alpha 


Updates firmware image for a device. Requires SYSPRV privilege. 

Format 

UPDATE DEVICE device-name 

Parameter 

device-name 

Specifies a device whose firmware is to be updated. The device name has the 
form ddcu where dd is the device code, c is the controller designation, and u is 
the unit number. LAN devices are specified as the name of the template device 
which is unit 0. For example, the first DE435 Ethernet device is specified as 
EWAO, the second as EWBO. 

Qualifiers 

/FILE 

Specifies the name of the file that is to be loaded into the EEPROM of the LAN 
device. 

/RESET (default) 

/NORESET 

Specifies whether the device is to be reset after it has been updated. Normally, a 
reset is done to get the device to begin running the new firmware. 

Example 


LANCP> UPDATE DEVICE FAAO/FILE=FBUS_MAIN.SYS 

Updates FDDI device FAAO with the firmware file FBUS_MAIN.SYS followed by 
a reset. ♦ 
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LAT Control Program (LATCP) Utility 











LATCP Description 

C ° ntro1 Pr0gram (LATCp ) utility is used to configure and control the 
LAI software on Open VMS systems. You can use LATCP to: 

• Specify operational characteristics for your node and its services 
Turn the state of the LAT port driver (LTDRIVER) on and off 

• Display the status of LAT services and service nodes in the network 

• Display the status of links created on your LAT node 

• Display the status of your LAT node 

• Show and zero LAT counters 

• Create, delete, and manage LAT ports 

Recall previously entered LATCP commands so that you can execute them 
again without having to retype them 

• Create subprocesses so that you can execute DCL commands without exiting 
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LATCP Usage Summary 

LATCP allows you to control the LAT software on a node and to obtain 
information from it. For example, you can use LATCP to create services on the 
local node, to associate a port on the local node with a service or device on a 
remote terminal server, and to display information about services offered on the 
local node or on other nodes in the network. 


When you use LATCP commands to change LAT characteristics (such as 
creating a service and associating a port with a service), the changes take effect 
immediately. However, when the LAT port driver stops, these characteristics are 
lost If you want these characteristics to be present the next time you start the 
LAT port driver, edit LAT$SYSTARTUP.COM by modifying or adding commands 
to set these characteristics. Then, invoke LAT$STARTUP.COM to start the LAT 
port driver. (See the OpenVMS System Manager’s Manual for more information.) 


Format 

RUN SYS$SYSTEM:LATCP 

Command Qualifiers 

None. 

Parameters 

None. 

Usage Summary 


Defaults 

None. 


To invoke LATCP, enter RUN SYS$SYSTEM:LATCP at the DCL command 
prompt. At the LATCP> prompt, you can enter any of the LATCP commands 
described in the following section. 

To exit from LATCP, enter the EXIT command at the LATCP> prompt or press 
Ctrl/Z. 

You can also execute a single LATCP command by using a DCL string assignment 
statement, as shown in the following example: 

$ LCP :== $LATCP 
$ LCP SET NODE/STATE=ON 

LATCP executes the SET NODE command and returns control to DCL. 
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LATCP Commands 

Table 13-1 summarizes the LATCP commands. 

Table 13-1 LATCP Commands 
Command Function 


ATTACH 

Transfers control from your current process to the 
specified process. 

CREATE LINK 

CREATE PORT 

CREATE SERVICE 

DEFINE/KEY 

Creates LAT data links. 

Creates a logical port on the local node. 

Creates a service on a service node. 

Assigns a command string to a function key on your 
keypad. 

DELETE LINK 

DELETE PORT 

DELETE QUEUE_ENTRY 

Deletes a LAT data link from a node. 

Deletes an application port or dedicated port. 

Deletes an incoming queued request from the local 
node. 

DELETE SERVICE 

EXIT 

HELP 

RECALL 

Deletes a service on a service node. 

Returns the user to DCL command level. 

Displays help text for LATCP commands. 

Recalls LATCP commands that you entered previously 
so that you can execute them again. 

REFRESH 

Refreshes your display screen, for example, after your 
display has been overwritten by output from some 
other source. 

SCROLL 

Allows you to retrieve information that has scrolled off 
the screen. 

SET LINK 

SET NODE 

SET PORT 

Modifies characteristics of LAT data links. 

Specifies LAT characteristics for a node. 

Maps a logical port on a node to either a remote device 
on a terminal server or a special application service on 
a remote LAT service node. 

SET SERVICE 

SHOW LINK 

SHOW NODE 

SHOW PORT 

SHOW QUEUE_ENTRY 

Changes service characteristics. 

Displays the characteristics of links on your node. 

Displays the characteristics of nodes. 

Displays port characteristics. 

Displays information about requests, or entries, 
queued on the local node. 

SHOW SERVICE 

Displays characteristics of LAT services known to your 
node. 

SPAWN 

ZERO COUNTERS 

Creates a subprocess. 

Resets the node counters, service counters, and link 
counters maintained by your node. 












LATCP 

ATTACH 


ATTACH 


Transfers control from your current process to the specified process. The LATCP 
ATTACH command is similar to the DCL ATTACH command. For example, from 
the DCL command level you can enter the DCL SPAWN command to create a 
LATCP subprocess without ending your DCL session, execute several LAI CP 
commands at the LATCP prompt, then use the ATTACH command to return to 

DCL. 


Format 


ATTACH [process-name] 


Parameter 

process-name , 1 

Specifies the name of a parent process or spawned subprocess to which control 
passes. The process must already exist, be part of your current job, and share the 
same input stream as your current process. 

Process names can contain from 1 to 15 alphanumeric characters. If a connection 
to the specified process cannot be made, LATCP displays an error message. 

If you specify the /PID qualifier, do not use the process name parameter. If you 
omit the /PID qualifier, you must use the process name parameter. 

To display processes, use the DCL SHOW SYSTEM command. 


Qualifier 

Specifies the process identification (PID) of the process that will have terminal 
control. When you specify a PID, you can omit the leading zeros^If you specify a 
PID, do not use the process name parameter. If you omit the PID qualifier, you 
must use the process name parameter. 


Description 


["he ATTACH command allows you to connect your input stream to another 
yrocess. You can use ATTACH to change control from one process to another 
r 0 r example, you can use ATTACH to change control from LATCP to the DCL 
command level (see the following example). While you are at the DCL command 
evel LATCP remains in a hibernation state until you use ATTACH to return to 


it. 

You cannot use this command if you are logged in to a captive account. (A captive 
account is an account set up to restrict user access to the system. You cannot 
access the DCL command level from a captive account.) You cannot specify both a 
process name and the /PID qualifier. 
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Example 

$ SET PROCESS/NAME="TOP_LEVEL" 
$ SPAWN RUN SYS$SYSTEM:LATCP 
LATCP> SHOW NODE/ALL 


LATCP> ATTACH "TOP_LEVEL" 

$ 

In this example, the user enters the DCL SPAWN command to create a LATCP 
subprocess and uses LATCP to display the status of all nodes known to the local 
node. After using LATCP, the user enters the ATTACH command to return to the 
DCL command level. 


CREATE LINK 


Creates the LAT data links, which are connections to LAN devices, such as 
Ethernet or FDDI (fiber distributed data interconnect) controllers, that you want 
your node to use. You must have OPER privilege to use this command. 

Format 

CREATE LINK link-name 

Parameter 

link-name 

Specifies a name for a LAT data link. A link name can have up to 16 ASCII 
characters. The characters allowed are as follows; 

• Alphanumeric characters: A-Z, a-z, 0-9 

• A subset of the international character set: ASCII codes 192-253 

Punctuation characters: dollar sign ($), hyphen (-), period (.), and 
underscore (_) 

You can create a maximum of eight links on your local node. Use the SHOW 
LINK command for a list of the link names that are defined for your node. 

Qualifiers 

/DECNET 

/NODECNET 

Directs LAT protocol to use the DECnet data link address (/DECNET) or the 
hardware address (/NODECNET) when starting the LAN controller If you do 
not specify the /DECNET or /NODECNET qualifier, the default is that the LAT 
protocol will use the DECnet data link address. 

Note that if you enter the CREATE LINK command with the /DECNET qualifier 
and receive an error message indicating a “bad parameter value,” it means the 
SCSSYSTEMID system parameter is set to an illegal value. To change the value 
of this parameter, use the following formula: 

(1024 * a) + n 
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In the formula, a is the DECnet area and n is the DECnet computer number. If 
the value is outside the range of 1025 to 65535, the LAT protocol cannot start. 

When you use the /NODECNET qualifier, the LAN device driver code determines 
which address to use. For example: 

• If SCSSYSTEMID is set to 0 but DECnet is already running on an Ethernet 
controller, the LAN device code allows LAT to use the same address as 
DECnet (AA-00-04-00-xx-xx). 

• If SCSSYSTEMID is set to 0 and DECnet is not running, the 08-00-2B-xx-xx- 
xx address is used (a different address format is used if your LAN controller 
is supplied by a vendor other than Digital). 

• If the setting for SCSSYSTEMID is the same as the DECnet node number 
and DECnet is not running, the LAN device code forces LAT to use the 
AA-00-04-00-xx-xx address. 

If DECnet is configured on the system (or if the system is part of a cluster), 
SCSSYSTEMID may contain a nonzero value. This is a problem only when the 
system has 2 or more LAN controllers connected to the same logical LAN. 

For example, if your system has an FDDI controller and an Ethernet controller, 
your site may be configured so that the FDDI ring attached to the FDDI controller 
and the Ethernet segment attached to the Ethernet controller are bridged by a 
10/100 LAN bridge (FDDI-to-Ethernet). In this configuration, it is impossible to 
run LAT over both controllers. 

In such a configuration, you must run LAT and DECnet over the same controller 
if SCSSYSTEMID is not 0. If you fail to do so, DECnet starts first, which in turn 
causes the LAT startup on the other controller to fail. This failure occurs because 
LAT startup tries to use the AA-00-04-00-xx-xx address (the DECnet LAN 
address) but is prevented from doing so by the data link layer. The LAT startup 
fails because DECnet is already using this address on a different controller. (In 
a single logical LAN, all data link addresses must be unique. In this setup, both 
controllers try to use the same address, which is then not unique.) 

The following command (which creates the LAT link) also fails because the LAN 
driver tries to use the address based on SCSSYSTEMID: 

LATCP> CREATE LINK LAT$LINK_2 /NODECNET 

If SCSSYSTEMID is set to 0, configuring LAT and DECnet on different 
controllers is possible. However, in a cluster environment, SCSSYSTEMID 
cannot be set to 0. 

/DEVICE=device-name 

Specifies the LAN controller device name for a LAT data link (for example, 
XEB0:). Only one LAT data link can be associated with a LAN controller. If 
you enter the CREATE LINK command without the /DEVICE qualifier, LATCP 
attempts to find an available controller by using a list of possible LAT data link 
device names. Digital advises that you specify a default device name by defining 
the LAT$DEVICE logical name. 

/LOG 

/NOLOG , , , 

Specifies whether LATCP displays a message confirming that the link was 
created. If you do not specify the /LOG or /NOLOG qualifier, the default is that 
no message will be displayed. 
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/STATE=option 

Specifies whether the link will be available for use. STATE can have two options: 

ON Specifies that the created link will be available for use with the LAT 
protocol running. 

OFF Specifies that the created link will not be available for use. 

If you do not specify the /STATE=option qualifier, the default is that the created 
link will be available for use (ON). 

Description 

The CREATE LINK command creates a link, or connection, for an Open VMS 
node and a local area network (LAN) device (for example, an Ethernet or FDDI 

tTtS 1 ^ and assigns a name t0 that link - An Open VMS node can have eight 
LAN links. Each link must operate on a separate LAN controller and have its 
own LAN hardware. 


Example 


If you do not explicitly create a link with this command before entering the 
f ET NO DE/s TATE= ON command, LATCP automatically creates a link for you. 
LATCP names the link LAT$LINK and assigns it to the first available LAN 

° r DEVICE, if defined. To establish additional links, use the 
CREATE LINK command. 


Whenever you create a link, specify the LAN controller device name 
Use the SET LINK command to modify link characteristics. 


LATCP> CREATE LINK NETWORK_A /DEVICE=XEBO: /STATE=ON 

L * NK command in this example creates an Ethernet link named 
JNEi WORK_A. It specifies the Ethernet controller device XEBO for that link. The 
link will be available for use. 


CREATE PORT 


Creates a logical port on your local node that connects with a remote device on 
a terminal server. Alternatively, this command creates a logical port on your 
local node that connects with a specific service. The service can be offered by a 

terminal server or associated with one or more dedicated ports on a remote LAT 
service node. 

You must have OPER privilege to use this command. 

Format 


CREATE PORT [port-name] 
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Parameter 

port-name , . 1 

Specifies the port name in the form LTAn:, where n is a unique number from 1 

through 9999. If the port you specify already exists, LATCP returns the following 

error message: 

%LAT-W-CMDERROR, error reported by command executor 

-SYSTEM-F-DUPLNAM, duplicate name 

If you do not specify the port name, you must specify the /LOGICAL qualifier. 

__ Notes ---— 

When creating a port, note the following: 

• Digital recommends that you assign a logical name when creating a 
port, instead of specifying a specific LTA device. 

• You cannot use the CREATE PORT and SET PORT commands, 
along with the DCL command SET TERMINAL, to change the 
characteristics of a DECserver port unless there is an existing LAT 
connection to that DECserver. 


Qualifiers 

/APPLICATION x Ti , 

Specifies that a logical port on your node is an application port. It can be used 
to connect to a remote device (typically a printer) on a terminal server or to a 
dedicated port on another LAT service node. 

If you do not specify a port type, the default port type is APPLICATION. 

__ Note-— 

By default, LATCP creates application LAT devices with the HANGUP 
terminal characteristic. However, if you want to apply the NOHANGUP 
characteristic to application LAT devices, you can do so by entering 
specific LATCP and DCL commands. For example. 

$ LCP :== $LATCP 

$ LCP CREATE PORT LTA1234 , Ir ^ nm . 

$ LCP SET PORT LTA1234 /APPLICATION /NODE=terminal_server /PORT=server_port 
$ SET TERMINAL LTA1234 /PERMANENT /NOHANGUP 

Note that you can insert the SET TERMINAL command in the 
SYS$MANAGER:LAT$SYSTARTUP.COM file (enter the command for 
each LAT device that requires the NOHANGUP characteristic). 


/DEDICATED . .. 

Specifies that a logical port on your local node is dedicated to an application 
service. When users on a terminal server (or on another node that supports 
outgoing connections) request a connection to this service name, they are 
connected to the dedicated port. See the OpenVMS 1/O User’s Reference Manual 
for a description of programming an application service. 
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After creating a dedicated port on a node, use the SET PORT /SERVICE 
command to map this port to a service. 

/LIMITED 

Specifies that a logical port on your local node is limited to a service in the same 
way a port created using the /DEDICATED qualifier is dedicated to an application 
service. The difference is that ports created using the /LIMITED qualifier are 
under the control of the system login image (LOGINOUT.EXE) instead of an 
application program (a user who connects to a limited service and is assigned to a 
limited port receives the “Username:” prompt). 

Using the /LIMITED qualifier, you can create a limited number of ports and map 
them to a specific service offered by the host system. If users are logged in to 
all of the limited ports for the service, no more connections are allowed to that 
service (terminal server users receive a “service in use” message). 

/LOG 

/NOLOG 

Specifies whether LATCP displays a message confirming that the port was 
created. If you do not specify the /LOG or /NOLOG qualifier, the default is that 
no message will be displayed. 

/LOGICAL=(NAME=logical-name[,TABLE=table][,MODE=mode]) 

Specifies a logical name to be associated with the actual name of the created port. 
You must specify a logical name if you do not specify a port name. 

-Note __ 

If you have sufficient privileges to create a port, but lack the privilege to 
assign a logical name, the port will still be created. 


You can specify one of the following options for the TABLE keyword: 


GROUP 

JOB 

PROCESS 


Places the logical name in the group logical name table. You 
must have GRPNAM or SYSPRV privilege to place the logical 
name in the group logical name table. 

Places the logical name in the jobwide logical name table. 

Places the logical name in the process logical name table. This 
is the default. 


SYSTEM 


Places the logical name in the system logical name table. You 
must have SYSNAM or SYSPRV privilege to place a name in 
the system logical name table. 


You can also specify the name of a specific table. For example, you could specify 
LNM$PROCESS, which would be the equivalent of specifying PROCESS. 


Options for the MODE keyword are: 


Creates an executive mode logical name. You must have 
SYSNAM privilege to create an executive mode logical name. 
Creates a supervisor mode logical name. 

Creates a user mode logical name. 

The access mode associated with the logical name is determined by maximizing 
the access mode of the caller with the access mode specified by the MODE 
keyword: the mode with the lower privilege is used. 


EXECUTIVE 

SUPERVISOR 

USER 
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You cannot specify an access mode with a privilege higher than that of the table 
containing the logical name. However, if your process has SYSNAM privilege, 
then the specified access mode is associated with the logical name regardless of 
the access mode of the caller. 

If you omit the MODE keyword, the access mode of the caller is associated with 
the logical name. 

Description 

The CREATE PORT command creates a logical LAT port for your local node. 

You can set up the port as an application port that is later mapped to a remote 
printer (or other device) on a server, or you can set up the port to be mapped to a 
dedicated port on a remote LAT service node. See Example 1. 

Alternatively, you can set up the port as a dedicated port for a special service on 
a LAT service node. See Example 2. 

You can also create the port as a limited port, using the /LIMITED qualifier. 

After creating a port, use the SET PORT command to associate (map) the 
port with a queue or a service. (See the discussion that follows Example 1.) 
Ordinarily, you create and set ports in the LAT site-specific startup procedure, 
LAT$SYSTARTUP.COM. See the OpenVMS System Manager’s Manual for more 
details. 

_ Note -- 

When using the CREATE PORT command to create an application port 
(for example, CREATE PORT LTA5001: /APPLICATION), you might 
receive an error message similar to the following: 

%LAT-W-CMDERROR, error reported by command executor 
-SYSTEM-F-DUPLNAM, duplicate name 

This error occurs because the LAT application port that you are trying 
to create has already been created by some other application. That other 
application could be LATCP itself because LATCP’s port, LATCP$MGMT_ 
PORT, is used to communicate with LTDRIVER. 

You can avoid creating duplicate ports in two ways: 

• Use the SET NODE/DEVICE_SEED command to move the lower 
boundary of the device unit number range beyond the LTA devices 
that you are intending to use as application ports. (By default, LTA 
device units that originate from the $ASSIGN system service to LTAO: 
have unit numbers that fall within a range from 1 through 9999.) For 
example, if you know that all LTA devices from LTA7000: onward are 
not used as application ports, you could enter the following commands: 

LATCP> SET NODE/DEVICE_SEED=7 000 
LATCP> CREATE PORT LTA5001:/APPLICATION 


LATCP> CREATE PORT LTA5010:/APPLICATION 

For more information, see the description of the /DEVICE_SEED 
qualifier in the SET NODE reference section. 
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• Execute the LATCP command SET NODE/STATE=ON (either 
interactively or in a program) before any LTA application or 
dedicated ports are created. Because every LATCP management port 
(LATCP$MGMT_PORT) created by the previous LATCP invocation is 
deleted, no conflict exists with LAT application ports or newly created 
dedicated ports. 

For more information, see the description of the /STATE qualifier in 
the SET NODE reference section. 


Examples 

1. LATCP> CREATE PORT LTA22: /APPLICATION 

The CREATE PORT command in this example creates an application port 
named LTA22: on a service node. You can associate the port with a specific 
printer on a terminal server (use the SET PORT /NODE /PORT command) 
or with a set of printers on a terminal server (use the SET PORT /NODE 
/SERVICE command). Or, you can associate the port with a dedicated port 
on a remote service node. In this case, use the SET PORT /NODE /SERVICE 
command, where the /SERVICE qualifier specifies an application service 
associated with a dedicated port on the remote node. See the examples for 
the SET PORT command. 

2. LATCP> CREATE PORT LTA21: /DEDICATED 

The CREATE PORT command in this example creates the LTA21: port. It 
will be used as a dedicated port that offers a specific service rather than a 
general timesharing service. 

3. LATCP> CREATE PORT /LOG /APPLICATION - 

_LATCP> /L0GICAL=(NAME=MAIL_PORT, TABLE=PROCESS, MODE=SUPERVISOR) 

The CREATE PORT command in this example creates an application port. 

It assigns the name of the new port to the specified logical name (MAIL_ 
PORT). The logical is created as a supervisor mode logical name in the 
LNM$PROCESS_TABLE logical name table. LATCP displays a confirmation 
message. 

4. $ LCP :== $ LATCP 

$ LCP CREATE SERVICE/LIMITED 0NLY_0NE 
$ LCP CREATE PORT/LIMITED LTA1234: 

$ LCP SET PORT LTA1234: /SERVICE=ONLY_ONE 

This series of commands creates a limited service that allows only one user 
to log in to the system through that service. When a user connects to service 
ONLY_ONE by responding to the terminal server prompt (Local>), the user is 
assigned port LTA1234 and then prompted for the user name. Any user who 
attempts to connect to the same service while LTA1234 has a user logged in 
receives the “service in use” message. 
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CREATE SERVICE 



Creates a service on a service node. You must have OPER privilege to use this 
command. 

Format 

CREATE SERVICE [service-name] 

Parameter 

service-name 

Specifies a LAT service name. By default, a service name is the name of the local 
node you defined with the SET NODE command. 

The service name can be from 1 to 16 ASCII characters in length. The characters 
allowed are as follows: 

• Alphanumeric characters: A—Z, a—z, 0—9 

• A subset of the international character set: ASCII codes 192-253 

• Punctuation characters: dollar sign ($), hyphen (-), period (.), and underscore 

(_) 

Qualifiers 

/APPLICATION 

Specifies that the created service is an application service. An application service 
offers a specific application on the service node rather than a general interactive 
service. You can define a dedicated port for the service by using the CREATE 

PORT and SET PORT commands. 

/IDENTIFICATION[= M identification-string"] 

Describes and identifies a service. Service nodes include the identification string 
in service announcements. A service node announces its services at regular 
intervals established with the SET NODE command. Entering the LATCP 

SHOW NODE command or the DECserver SHOW NODE command generates 
a display that includes this identification string. By default, the identification 
string is a translation of SYS$ANNOUNCE. 

You cannot specify more than 64 ASCII characters in an identification string (a 
SYS$ANNOUNCE longer than that will be truncated to the first 64 characters). 

Enclose the string in quotation marks ("). 

/LIMITED 

Specifies that the service is a limited service, using devices assigned the limited 
characteristic and associated with (mapped to) this limited service. This qualifier 
is used in conjunction with the SET PORT /LIMITED command (see example). 

/LOG 

/NOLOG 

Specifies whether LATCP displays a message confirming that the service was 
created. If you do not specify the /LOG or /NOLOG qualifier, the default is that 
no message will be displayed. 
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/STATIC_RATING=rating 

/NOSTATIC_RATING 

Enables or disables dynamic service ratings. A dynamic service rating means 
that a LAT algorithm calculates the availability of a service dynamically, based on 
the overall level of activity of the node that offers the service and the amount of 
memory When a terminal server or node requests a connection to a service that 
18 offered on two or more service nodes, the requesting node selects the service 
node with the highest (most favorable) service rating. This selection process is 
called load balancing. 

The dynamic service rating, which is the default, is usually adequate for efficient 

/STATIC RATTNr he ^ H ? Wever ’ when necessary, you can use the 

/blAliC_KAT ING qualifier to disable dynamic service ratings so that you can 

speci y a static (fixed) rating. That static rating value does not change until the 
dynamic service rating is reenabled. 

Use the static rating to direct users away from or toward your node temporarily 
Static ratings range from 0 to 255. Specify a low value to make the local service 

node less likely to be used; specify a high value to make the local service node 
more likely to be used. 

If you do not specify either the /STATIC_RATING or /NOSTATIC_RATING 
qualifier, the default is that the LAT software uses the dynamic service ra ting . 

Limited and application services do not rely exclusively on the dynamically 
calculated service rating. Instead, they use a portion of the dynamic rating based 

h 1 h =ncy m r n f POrtS are available for the service. For example, if a limited service 
has 50% of its ports available, the dynamic service rating will be scaled, halved 

th e d value 105 6d t0 105 ’ P ° rtS are avaiIable > the ratin g will always be above 

When all ports for a limited or application service are in use, the rating will be 
based on the scaled dynamic rating and the number of free queue slots on the 
local node. The rating will always be less then 90. 

This rating procedure for limited and application services follows the terminal 
server rating algorithm for services and available ports that the service offers 
while at the same time taking into account the availability of the node (which’is 
the factor used to calculate the dynamic rating). 

If your system is licensed for a specific number of units (where only a fixed 
number of users can log in to the system regardless of how the login limit is set) 
then all dynamic ratings become 0 when all OpenVMS license units have been ’ 
consumed. (This forces all node service ratings to the lowest possible value when 
logins are not possible because all OpenVMS license units have been consumed.) 

Note as well that the LAT software transmits a service announcement message 
when a user logs in to or out of the system. This allows the system to more 

quickly provide information about service rating changes that result from a login 
or logout operation. & 
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Description 

The CREATE SERVICE command creates a service that a service node offers 
to terminal servers (and nodes that support outgoing connections) on the LAT 
network. The service can be a general timesharing service that offers all the 
resources of the service node, or it can be an application service that offers a 
specific application on the service node. The number of services that you can 
create with the CREATE SERVICE command depends on the availability and 
capability of specific resources. 

The following table lists the maximum number of services your node can offer 
and still be recognized by the DECserver terminal server, depending on the model 

number. 


DECserver Terminal Server 

Maximum Number of Services 

Offered by Node 

Model 100 

8 

Model 200 

64 

Model 300 

64 

Model 90TL 

64 

Model 700 

64 

Model 500 

127 


Note 


If you create more than the maximum number of services supported by a 
specific DECserver model, that server will not recognize your node. 


To create an application service, use the /APPLICATION qualifier In addition, 
define a dedicated port by using the CREATE P ° R ^ and »ETPORT commands. 
Most often, a system manager creates services in LAT$SYSTARI UP.WJM, t ^ 
site-specific LAT configuration procedure. (See the OpenVMS System Manager s 
Manual for further information on creating an application service. The OpenVMS 
I/O User’s Reference Manual shows how to program an application service.) 


Several service nodes can share one service name. A shared service name is 
especially useful in a cluster environment because it allows the cluster to be 
known by a single cluster name. When a user logs in, the terminal server 
connects to the least busy node offering that service. 


You can modify the service characteristics with the SET SERVICE command. 


Examples 

l latcp> CREATE SERVICE/STATIC_RATING=195 sales 

The CREATE SERVICE command in this example creates the service 
SALES on a service node. This command assigns a static rating of 195 so 
terminal servers (and nodes that support outgoing connections) can assess the 
availability of services on the node. 
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2. LATCP> CREATE SERVICE/APPLICATION GRAPHICS 

This command creates the service GRAPHICS on the local node. Use 
the CREATE PORT/DEDICATED and SET PORT/SERVICE=GRAPHICS 
commands to create a port that is dedicated to this service. 

3. $ LCP :== $ LATCP 

$ LCP CREATE SERVICE/LIMITED 0NLY_0NE 
$ LCP CREATE PORT/LIMITED LTA1234: 

$ LCP SET PORT LTA1234: /SERVICE=ONLY_ONE 

This series of commands creates a limited service that allows only one user 
to log in to the system through that service. When a user connects to service 
ONLY_ONE by responding to the terminal server prompt (Local>), the user is 
assigned port LTA1234 and then prompted for the user name. Any user who 
attempts to connect to the same service while LTA1234 has a user logged in 
receives the “service in use” message. 


DEFINE/KEY 


Assigns a command string to a function key. For example, you can assign the 
LATCP SHOW NODE command to a function key. 

Format 

DEFINE/KEY key-name equivalence-string 

Parameters 

key-name 

Specifies the name of the function key that you want to define. Valid key names 
are as follows: 


Key Name 

LK201/LK401 Keyboards 

VT100-Type 

VT52-Type 

PFl 

PFl 

PFl 

Blue 

PF2 

PF2 

PF2 

Red 

PF3 

PF3 

PF3 

Black 

PF4 

PF4 

PF4 


KP0-KP9 

Keypad 0-9 

Keypad 0-9 

Keypad 0-9 

PERIOD 

Keypad period (.) 

Keypad period (.) 


COMMA 

Keypad comma (,) 

Keypad comma (,) 


MINUS 

Keypad minus (-) 

Keypad minus (-) 


Enter 

Enter 

Enter 

Enter 

FIND 

Find 

_ 


INSERT.HERE 

Insert Here 

_ 


REMOVE 

Remove 

_ 


SELECT 

Select 

_ 


PREVJ3CREEN 

Prev Screen (LK201) 

Prev (LK401) 

- 

- 
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Key Name 

LK201/LK401 Keyboards 

VT100-Type 

VT52-Type 

NEXT_SCREEN 

Next Screen (LK201) 

Next (LK401) 

- 

- 

HELP 

Help 

- 

— 

DO 

Do 

— 

— 

F6-F20 

F6-F20 

— 



equivalence-string 

Specifies the command string that you want assigned to the function key. 

To preserve spaces and lowercase characters, enclose the string in quotation 
marks (" "). 


Qualifiers 

/ECHO 

/NOECHO 

Specifies whether LATCP displays the command string on your screen when you 
press the key. If you do not specify the /ECHO or /NOECHO qualifier, the default 
is that the command string will be displayed. You cannot use /NOECHO with the 
/NOTERMINATE qualifier. 

/IF_STATE=state-name 

Specifies the state that must be set (for example, the GOLD state) for the key 
definition to work. Lets you assign alternative meanings to keys when the 
specified state is set. See the discussion of the /SET_STATE qualifier. If you omit 
the /IF_STATE qualifier, LATCP uses the current state. The state name is an 
alphanumeric string. States are established with the /SET_STATE qualifier. 

/LOCK_STATE 

/NOLOCK_STATE 

Specifies that the state set by the /SET.STATE qualifier remain in effect until 
explicitly changed. If you use the /NOLOCK_STATE qualifier, the state set by 
/SET_STATE remains in effect only for the next definable key that you press or 
for the next read-terminating character (such as Return or Ctrl/Z) that you type. 

You can specify the /LOCK.STATE qualifier only with the /SET.STATE qualifier. 
If you do not specify the /LOCK.STATE or /NOLOCK.STATE qualifier, the 
default is that the state set by the /SET_STATE qualifier remains in effect until 
explicitly changed. 

/LOG 

/NOLOG 

Specifies whether LATCP displays a message confirming that the command was 
executed. If you do not specify the /LOG or /NOLOG qualifier, the default is that 
no message will be displayed. 

/SET_STATE=state-name 

Causes the specified state to be set when you press the defined key. The state 
name can be any alphanumeric string (for example, GOLD). Use the DEFINE 
/KEY/IF_STATE=state-name command to associate new meanings for keys when 
the specified state is set. See the example for the DEFINE/KEY command. 

If you omit the /SETJ3TATE qualifier, the current state that was locked remains 
in effect. 
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/TERMINATE 

/NOTERMINATE 


Specifies whether the command string will be terminated (processed) when you 
press the function key. The default is /NOTERMINATE, which allows you to 
press other keys before the command string is processed. Pressing Return has 
the same effect as using /TERMINATE. 


The /NOTERMINATE qualifier allows you to create key definitions that insert 
text mto command lines, after prompts, or into other text that you are typing. 


Description 

The DEFINE/KEY command assigns a command string to a function key so that 
when you press that key the command is executed. 

Example 


LATCP> DEFINE/KEY PF4 
LATCP> DEFINE/KEY PF4 


"SHOW NODE ■ /NOTERMINATE/SET_STATE=GOLD 
"/ALL"/IF_STATE=GOLD/TERMINATE 


The first DEFINE/KEY command in this example assigns the SHOW NODE 
command to function key PF4. To process the SHOW NODE command, you must 
press Return after pressing PF4. Note the space after the word NODE in the 
first DEFINE/KEY command. This space allows you to enter a node name after 
pressing PF4. When you press Return, the SHOW NODE command is processed. 
It the space is omitted, LATCP does not recognize the command (SHOW NODE). 

The state is set to GOLD; that state will be in effect for the next key that you 
press. J 


The second DEFINE/KEY command defines the use of the PF4 key when the 
keypad is in the GOLD state. When you press PF4 twice, the SHOW NODE/ALL 
command is processed. 


DELETE LINK 


Format 


Deletes a logical link from a node. You must have OPER privilege to use this 
command. 


DELETE LINK link-name 


Parameter 

link-name 

Specifies the name of the link that you want to delete. 

Use the SHOW LINK command for a list of the links that are defined for your 
node. 
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Qualifiers 

/LOG 

/NOLOG „ . _ x . 

Specifies whether LATCP displays a message confirming that the link was 
deleted. If you do not specify the /LOG or /NOLOG qualifier, the default is t a 
no message will be displayed. 


Description 

The DELETE LINK command stops any active sessions on the link and then 
deletes the link from your node. 


Example 

LATCP> DELETE LINK NETW0RK_A /LOG 

The DELETE LINK command in this example deletes the link NETWORK_A. 
The link was created with the CREATE LINK command. 


DELETE PORT 

Deletes a logical port from a node. You must have OPER privilege to use this 
command. 


Format 

DELETE PORT port-name 

Parameter 


Specifies the name of the application port or the dedicated port that you want 
to delete. An application port connects to a remote device on a terminal server, 
whereas a dedicated port connects to a special service. 

Use the SHOW PORT command for a list of the application ports and the 
dedicated ports that are defined for your service node. You cannot use the 
DELETE PORT command to delete an interactive or forward LAT port. 


Qualifiers 

/LOG 

/NOLOG 

Specifies whether LATCP displays a message confirming that the port was 
deleted. If you do not specify the /LOG or /NOLOG qualifier, the default is that 
no message will be displayed. 


Description 

The DELETE PORT command stops any active session on the port and then 
deletes the port from your service node. 
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Example 

LATCP> DELETE PORT LTA27: 

Th e DELETE PORT command in this example deletes the LTA27: application 
port. The port was created with the CREATE PORT command. 


DELETE QUEUE ENTRY 

Deletes an incoming queued request, or entry, from the local node. 

Format 


delete QUEUE_ENTRY queue-entry-id 

Parameter 


queue-entry-id 

delete^ 68 ^ identificati0n number (ID) of the Queued entry that you want to 

Use the SHOW QUEUE_ENTRY command to view the list of queued entries and 
their IDs. 


Description 


The DELETE QUEUE_ENTRY allows you to delete an incoming queued request 
or entry, from the local node. Use the SHOW QUEUE_ENTRY command to view 
the list of queued entries. 


Example 


LATCP> DELETE QUEUE_ENTRY 0056 

Tb ® ^f LETE QUEUE_ENTRY command deletes the queued request with an ID 


DELETE SERVICE 

Deletes a service that your service node currently offers. You must have OPER 
privilege to use this command. 

Format 


DELETE SERVICE service-name 

Parameter 

service-name 

Specifies the name of the service, as displayed by the SHOW SERVICE command. 
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Qualifiers 


/LOG 

/NOLOG 

Specifies whether LATCP displays a message confirming that the service was 
deleted. If you do not specify the /LOG or /NOLOG qualifier, the default is that 
no message will be displayed. 


Description 

The DELETE SERVICE command removes a service from a service node. The 
service is no longer available to terminal server users and is no longer multicast 
in the configuration messages sent by your service node. Existing connections to 
the service node are not affected. 


Example 

LATCP> DELETE SERVICE SALES 

The DELETE SERVICE command in this example removes the service SALES 
from your service node. The service is no longer available to server users. 


EXIT 


Stops execution of LATCP and returns control to the DCL command level. You 
can also enter Ctrl/Z at any time to exit. 

Format 

EXIT 

Parameters 

None. 

Example 

LATCP> EXIT 

The EXIT command in this example exits the LATCP program and returns 
control to the DCL command level. 


HELP 


Provides online help information for using the LATCP commands. 


Format 

HELP [command-name...] 
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Parameter 

command-name 

The name of a LATCP command or LATCP command and command keyword. 

If you enter the HELP command with a command name only, such as HELP 
SET, LATCP displays a list of all of the command keywords used with the SET 
command. 

Description 

The HELP command is an online reference for LATCP commands. After you 
view an initial help display, press Return. The help display stops and the LATCP 
prompt is displayed. If you do not specify a command name, the HELP command 
displays general information on the commands for which help is available. 
Supplying a command name obtains syntax information for that command. 

Example 

LATCP> HELP SET PORT 

In this example, the HELP SET PORT command produces a description of the 
SET PORT command and shows the command format. 


RECALL 


Displays previously entered LATCP commands on the screen so that you can 
execute them again. 

Format 

RECALL [command-specifier] 

Parameter 

command-specifier 

Specifies the number or the first several characters of the LATCP command you 
want to recall. Command numbers can range from 1 to 20. The most recently 
entered command is number 1. 

Use the /ALL qualifier to display all the commands in the RECALL buffer, 
along with their command number so that you can determine the number of the 
command that you want to recall. 

If you do not include the command specifier or the /ALL qualifier when entering 
the RECALL command, LATCP displays the last command. 

Qualifiers 


/ALL 

Specifies that LATCP display all the commands in the RECALL buffer. LATCP 
displays the number of each command. 
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♦ 


Description 

When you enter a LATCP command, LATCP stores it in a RECALL buffer for 
later use with the RECALL command. The RECALL command itself is never 
stored in the RECALL buffer. 

When you use the RECALL command, LATCP displays the recalled command 
but does not process it. If you want the command processed as it appears, press 
Return. You can use the command line editing facility to make minor changes 
in the command line and then press Return to process the revised version of the 
command. 

Examples 

1. LATCP> RECALL 2 

In this example, the RECALL command recalls the second-to-last command 
you entered. 

2. LATCP> RECALL SET 

In this example, the RECALL command recalls the last SET command you 
entered. 


REFRESH 


Refreshes the display screen so that any output from some other source (such as 
a broadcast message) is erased from the screen. 


Format 

REFRESH 

Description 

Use the REFRESH command to refresh your display screen after output from 
other sources has overwritten the display screen. For example, if a broadcast 
message from a terminal server user is displayed on your screen, use the 
REFRESH screen to erase the broadcast message from the display. By default, 
you can refresh your screen by pressing Ctrl/W at the LATCP prompt. 

Example 

LATCP> REFRESH 

In this example, the REFRESH command refreshes the display on your screen. 
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SCROLL 

Allows you to retrieve information that has scrolled off the screen, either up or 


Format 

SCROLL 

Parameters 

None. 

Qualifiers 

/DOWN[=value] 

Scrolls the LATCP screen display down the number of lines indicated by the 
specified value. For convenience, you can also use the Next (or Next Screen) 
key on your keyboard to scroll down 15 lines (instead of entering the SCROLL 
/DOWN=15 command). 

If you do not specify a value, the default value is 1. 

/UP[=value] 

Scrolls the LATCP screen display up the number of lines indicated by the 
specified value. For convenience, you can also use the Prev (or Prev Screen) key 
on your keyboard to scroll up 15 lines (instead of entering the SCROLL/UP=15 
command). 

If you do not specify a value, the default value is 1. 

Description 

The SCROLL command allows you to retrieve information that has scrolled off 
the screen (either up or down). The command works only after a LATCP SHOW 
command has produced output that scrolled off the screen display area Each 

- b -r nt SH ° W command erases the Previous output area such that the 
command retrieves the screen display produced by the last executed 
SHOW command. 

Example 


LATCP> SCROLL /UP=5 

The SCROLL command in this example allows you to scroll up to view five lines 
of screen display that has previously scrolled off the viewing area. 
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SET LINK 

Changes the characteristics of LAT data links. You must have OPER privilege to 
use this command. 

Format 

SET LINK link-name 

Parameter 

link-name , , Acr , TT 

Specifies the name for a LAT data link. A link name can have up to 16 ASCII 

characters. The characters allowed are as follows: 

• Alphanumeric characters: A—Z, a—z, 0—9 

• A subset of the international character set: ASCII codes 192-253 

• Punctuation characters: dollar sign ($), hyphen (-), period (.), and underscore 

(_) 

The SHOW LINK command displays the names of the links defined for a node. 


Qualifiers 

/LOG 

/NOLOG „ . , | * i) 

Specifies whether LATCP displays a message confirming that the lmk s 
characteristics were modified. If you do not specify the /LOG or /NOLOG 
qualifier, the default is that no message will be displayed. 


^p^chfesTvailability of the link for use. The two options for STATE are: 


ON 

OFF 


Specifies that the link will be available for use with the LAT 
protocol running. 

Specifies that the link will not be available for use. 


If you do not specify the /STATE=option qualifier, the default is that the link will 
be available (ON). 


Description 

The SET LINK command allows you to change the characteristics for a LAT data 
link, which must have been created previously in one of the following ways: 

• Interactively entering the CREATE LINK command 

• Using the SET NODE/STATE=ON command to create a default link named 
LAT$LINK (if no other links are created when that command executes) 

• Running a program that creates links 
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Example 


LATCP> SET LINK NETWORK_A /LOG /STATE=0N 


The SET LINK command in this example directs LATCP 
for link NETWORK_A and then to display a confirmation 


to start the controller 
message. 


SET NODE 


Format 


Parameter 


Qualifiers 


Specifies the LAT characteristics of your local node. You must have OPER 
privilege to use this command. 


SET NODE [node-name] 


node-name 

Specifies a node name for your local node. By default, the node name is the 
translation of SYS$NODE. A LAT node name should be the same as the DECnet 
node name If the node is not running DECnet but will be in the future, Digital 

recommends that you define SYS$NODE and use it for both DECnet and LAT 
node names. 

A LAT node name can be from 1 to 16 ASCII characters. The characters allowed 
are as follows: 

• Alphanumeric characters: A-Z, a-z, 0-9 

• A subset of the international character set: ASCII codes 192-253 

• Punctuation characters: dollar sign ($), hyphen (-), period (.), and underscore 


/Cl RCU IT_TIM E R [=msecs] 

Allows you to control the interval in milliseconds (msecs) between messages sent 
from the local node to other service nodes or terminal servers while connections 
to those nodes are active. Use this qualifier only if your node allows outgoing 
connections (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH). 

A low value for the interval decreases the response time for the port but increases 

the demand on service nodes. Set the circuit timer in the range of 10 to 1000 
msecs. 

The default value of 80 msecs gives a generally acceptable response time while 
creating a moderately low overhead on the service nodes. You cannot change this 
parameter when active or pending LAT connections exist. 

/CONNECTIONS=option 

Allows you to specify the type of connections permissible on the local node The 

four options for CONNECTIONS are: 
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INCOMING_ONLY 

OUTGOING.ONLY 


BOTH 


NONE 


Specifies that the local node permit incoming connections 
only. 

Specifies that the local node permit outgoing connections 
only. Specify this on systems that can tolerate the 
overhead associated with outgoing connections, such as 
standalone systems. 

Specifies that the local node permit both incoming and 
outgoing connections. Specify this on systems that 
can tolerate the overhead associated with outgoing 
connections, such as standalone systems. 

Specifies that the local node disallow both incoming and 
outgoing connections. 


If you do not specify the /CONNECTIONS=option qualifier, the default is that the 
node will permit incoming connections only. 


/CPU_RATING=cpu-power 

/NOCPUJWING t 

The /CPUJRATING qualifier assigns your local node a rating that represents tne 
power of your node’s CPU (central processing unit) relative to other CPUs in the 
LAN. The value of cpu-power can range from 1 (for a CPU with the lowest power) 
to 100 (for a CPU with the highest power). 

When a terminal server or node requests a connection to a service that is offered 
on the local node and one or more other service nodes, the requesting node selects 
the service node with the highest (most favorable) service rating, based on the 
overall level of activity of the node that offers the service and the amount of 
memory. This selection process is called load balancing. 

You can influence the rating for services on your node by specifying a value for 
the /CPU_RATING qualifier. If you specify a high value for cpu-power, the LA 
driver will calculate a relatively high service rating for services on your node 
(service ratings as high as 255 are possible). If you specify a low value the LAT 
driver will calculate relatively low service ratings; connections will most likely be 
made to the same service that is offered on other nodes. In either case, the LA 
driver can calculate a greater range of values for dynamic service ratings e 
entire range from 0 to 255). Consequently, the ratings will more accurately reflect 

the availability of the service node. 

If you do not specify either the /CPU_RATING=cpu-power or /NOCPU.RATING 
qualifier, the default is that no CPU rating will be used A value of 0 indicates no 

CPU rating. 

Sts the default starting number (within a range from 1 through 9999) for the 
unit numbers that will be assigned to new LTA devices^ Note that when ports are 
created by assigning a channel to LTAO: with the $ASSIGN system service, the 
channel numbers fall in this same range. 

The default device seed value is approximately half of the maximum unit number 
(which you set by using the AJNIT_NUMBER_MAXIMUM qualifier). Interactive 
LAT ports, and those created with the CREATE PORT/LOGICAL comman , 
are assigned unit numbers beginning with the specified device seed value and 
continuing up to the maximum unit number. When the maximum unit number 
is reached, the port is assigned the next available unit number beginning at the 
bottom of the range (LTA1:). 
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Note that each time you specify the /UNIT_NUMBER_MAXIMUM qualifier, the 
device seed value is reset to approximately half of the newly specified maximum 
unit number. 

/FORWARD_SESSION_LIMIT[=value] 

Controls the number of sessions (a value within a range from 16 through 255) 
allowed on each outgoing connection. By default, 16 sessions are allowed on an 
outgoing connection, which means that 16 individual processes can direct the 
DCL command, SET HOST/LAT, to the same remote node. 

You must increase the value for the /FORWARD_SESSION_LIMIT qualifier if a 
user on your system enters the command, SET HOST/LAT, and receives an error 
message indicating that the session limit for the LAT circuit has been reached ( 
%LAT-F-VCSESLIM). Note, however, that you can change this value only when 
no connections exist. 

/GROUPS=option[,...] 

Gives the listed groups access to services offered on your local node or prevents 
the listed groups from accessing services offered on your local node, depending on 
the options used. 

A network manager organizes terminal server nodes into groups based on the 
number of terminal server nodes in the LAT network. Groups subdivide the LAT 
network, limiting the number of terminal server nodes that can connect with a 
given service node. 

As manay as 256 groups, numbered 0 through 255, can be in the LAT network. 
By default, all terminal server nodes and nodes supporting outgoing connections 
belong to group 0. If you enter one group code, you can omit the parentheses. 

Use the SHOW NODE command for a list of the groups enabled for your service 
node. 

The /GROUPS qualifier has several options. For each option described, you can 
specify more than one group by: 

• Listing them separated by commas 

• Specifying a range 
The available options are: 

ENABLE=group-code[,...] Gives the listed groups access to your service 

node. 


DISABLE=group-code[,...] 


ENABLE=group-code[,...], 
DISABLE=group-code[,...] 


Prevents the listed groups from accessing your 
service node. The listed groups had been enabled 
previously for access to your node. 

This option lets you enable certain groups and 
disable other groups in one command line: gives 
access to the groups listed with the ENABLE 
option and removes access from the groups 
listed with the DISABLE option. Enclose both 
ENABLE and DISABLE in parentheses; for 
example, /GROUP=(ENABLE=(10,12), 
DISABLED 1-30)). 


Example 2 shows how to specify the /GROUPS qualifier with the SET NODE 
command. 
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/IDENTIFICATION[="identification-string"] 

Describes and identifies a node. Service nodes include the identification string in 
service announcements. A service node announces its services at regular intervals 
established with the SET NODE command. Entering the LATCP SHOW NODE 
command or the DECserver SHOW NODE command generates a display that 
includes this identification string. By default, the identification string is the 
translation of SYS$ANNOUNCE. 

You cannot specify more than 64 ASCII characters in an identification string (a 
SYS$ANNOUNCE longer than that will be truncated to the first 64 characters). 
Enclose the string in quotation marks (" "). 

/KEEPALIVE_TIMER[=secs] 

Allows you to control the maximum interval between idle run messages sent by 
your local node to another service node to which it has a LAT connection. The 
interval is in seconds. Your node sends these messages when no other traffic is 
being generated over the virtual circuit. If the service node acknowledges these 
messages, your node will continue to monitor the status of the circuit. If your 
node does not receive acknowledgment, it responds as if the circuit is down. 

Use this qualifier only if your node allows outgoing connections 
(/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH). 

The default value is 20. Digital recommends this value for normal LAN 
environments. For a heavily loaded LAN, consider using a higher value. Set the 
timer in the range of 10 to 255. For applications that require quick notification 
and possible failover of a service node failure, use a lower value. You cannot 
change this value if active or pending connections exist. 

/LOG 

/NOLOG 

Specifies whether LATCP displays a message confirming that the nodes 
characteristics were modified. If you do not specify the /LOG or /NOLOG 
qualifier, the default is that no message will be displayed. 

/MULTICAST_TIMER[=secs] 

Specifies the time, in seconds, between multicast messages sent by a service 
node. A multicast message announces the services offered by a service node. The 
minimum value is 10 seconds; the maximum is 180 seconds. The default value is 

60. 

/NODE_LIMIT=value 

/NONODEJJMIT 

Specifies the maximum number of service nodes that your local node can store in 
its service and node database. Use this qualifier only if your node allows outgoing 
connections (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH). 

When the database reaches the node limit, no more nodes are added to the 
database when your local node receives service announcement messages. You can 
ensure that the node limit is not reached by using the /USER_GROUPS qualifier 
to restrict access from the local node to other service nodes on the network. 

If you do not specify either the /NODE_LIMIT=value or /NONODE_LIMIT 
qualifier, the default is no limit. A value of 0 indicates no limit. 
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/QUEUE_UMIT=value 

Allows you to set a limit on the number of entries (incoming LAT connections 
only not outgomg printer connections) that are queued on the system. The queue 

limit value can range from 0 to 200, with a default of 24. A value of 0 indicates 
that no queuing is allowed. 

/RETRANSMIT_LIMIT[=count] 

Specifies the number of times your local node repeats transmission of a 
message to a service node after a transmission fails. If the transmission is 
still unsuccessful after these attempts, the virtual circuit between your local 

node and the service node terminates, along with all sessions associated with the 
virtual circuit. 

Use this qualifier only if your node allows outgoing connections 

(/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH). 

Specify a value in the range of 4 to 120. The default is 8. The value you choose 
depends on the type of physical link used for your network, as well as the amount 
of traffic on the network. See your network manager for a suggested value. You 
cannot change this value if active or pending connections exist. 

/SERVICE_RESPONDER 

/NOSERVICE_RESPONDER 

Specifies whether your system responds to special LAT multicast messages that 
request service information. Some terminal servers do not have their own service 
and node database. When a user on such a terminal server requests a connection 
to a service, the server sends a LAT multicast message requesting names of 

nodes that offer the requested service. Service responder nodes reply with the 
requested information. 

If you specify /SERVICE_RESPONDER, your system responds to the special LAT 
multicast messages. (If you specify /NOSERVICE_RESPONDER, your system 
does not respond to those messages.) Digital recommends that you set up only one 
or two nodes m the LAN as service responder nodes. The nodes should have the 
largest databases in the LAN. Use this option only if your node allows outgoing 
connections (/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH). 

do not specify either the /SERVICE_RESPONDER or /NOSERVICE 

RESPONDER qualifier, the default is that your system will not respond to the 
special LAT multicast messages. 

/SESSION_LIMIT=option 

Specifies the maximum number of simultaneous sessions across all local-access 
ports This limit does not affect the use of dedicated and application ports It 
affects interactive port creation only, limiting the amount of resources consumed 
by interactive users creating new sessions. 

The options for the /SESSION_LIMIT qualifier are: 


INCOMING=value 


OUTGOING=value 


Sets the session limit for incoming 
connections only. The default is 
no limit (a value of 0). 

Sets the session limit for outgoing 
connections only. The default is 
no limit (a value of 0). 
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INCOMING=value,OUTGOING=value Sets the limit for both 

outgoing and incoming 
connections. Enclose both 
options in parentheses; 
for example, /SESSION. 
LIMIT=(INCOMING=20, 
OUTGOING=25). 

• A high limit allows users to have more sessions but increases memory 
utilization on your local node. 

• A low limit decreases memory utilization on your local node but limits user 
access to services on the network. 


If the limit is reached, interactive users cannot create new sessions In this case, 
increase the session limit or disconnect any connections that are no longer being 


used. 


Specify a value in the range of 0 to 255. 
number of sessions that can be created, 
use the /CONNECTIONS qualifier. 


Specifying 0 leaves no limit on the 
To prevent sessions from being created, 


Not specify the /SESSION.LIMIT qualifier causes no limit on the number of 
incoming and outgoing sessions. This is the default. 


/STATE=option 

Specifies whether LAT connections are 


allowed. The three options for STATE are. 


Starts the LAT port driver (and LAT protocol software) on your 
node. 

Digital strongly recommends that the LATCP command SET 
NODE/STATE=ON be executed before any LTA application 
or dedicated ports are created (use the format provided in 
SYS$MANAGER:LAT$SYSTARTUP.TEMPLATE) for two reasons: 

• It ensures that LTDRIVER will delete any leftover LTA devices 
that have a reference count of 0 and are explicitly marked for 
deletion (using the $DASSGN system service or the LATCP 
DELETE PORT command, for example). Because every LATCP 
management port (LATCP$MGMT_PORT) that was created by 
the previous LATCP invocation is deleted, no conflicts result 
with the LAT application ports or newly created dedicated 
ports. 

• The deletion of leftover LTA devices with a reference count of 0 
minimizes the use of nonpaged pool memory. 

Stops the LAT port driver (and LAT protocol software) on 
your node. Any existing LAT connections are aborted. Any 
characteristics that you changed or set with LATCP are lost. 

To start the LAT protocol on your node again, invoke 
LAT$STARTUP.COM. (See the OpenVMS System Manager’s 
Manual for more information.) The LAT characteristics defined 
in LAT$SYSTARTUP.COM will take effect. 
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SHUT 


Specifies that new LAT connections cannot be created on your local 
node, but existing connections may continue. The LAT protocol 
continues running only until the last active session disconnects 
(after which LTDRIVER will stop). At that time, your node changes 
to the OFF state. 


Caution 


If you stop the LAT software by specifying either the SET NODE 
/STATE=OFF or SET NODE/STATE=SHUT command, the LAT print 
symbiont (LATSYM) will shut down all print queues that it is processing 
The system will then generate an OPCOM message indicating that the 
print queues are stopped. You must manually restart those print queues. 


If you do not specify the /STATE=option qualifier, the default is that the LAT port 
driver and LAT protocol software on your node will be started (ON). 

/UNIT_NUMBER_MAXIMUM=value 

Specifies the maximum unit number for a LAT device. For example, if you specify 
140, then LTA140: will be the device with the highest unit number. Specify 
a value that is high enough to accommodate all devices that may be in use 
simultaneously. When the number of devices in use exceeds the value you specify 
the system gives certain LAT devices unit numbers that exceed your maximum. 

Note the following as well: 

When LATCP reaches the maximum unit number, it will continue to implicitly 
create LTA devices beginning with the lowest available unit number. 

• You cannot use the System Generation (SYSGEN) utility to set the maximum 
unit number for a LAT device. 

The range of maximum unit numbers is 99 through 9999. The default is 9999 
Note that each time you specify the /UNIT_NUMBER_MAXIMUM qualifier 
the LTA device seed value is reset to approximately half of the newly specified 
maximum unit number. 

/USER_GROUPS=option[,...] 

Restricts access (from the local node) to service nodes in the network that belong 
to the specified groups. Your local node can access only those service nodes 
associated with the user groups specified. The /USER_GROUPS qualifier also 
serves to limit the number of nodes stored in your node’s node database (The 
ocal node only stores information about the nodes and services that belong to at 

least one of the specified user groups.) By default, all LAT service nodes belong to 
group 0. 6 

This qualifier affects your local node when outgoing connections are enabled 

(/CONNECTIONS=OUTGOING_ONLY or /CONNECTIONS=BOTH). 

Use the SHOW NODE command for a list of the user groups (service groups) 
enabled for your node. H 

The /USER_GROUPS qualifier has several options. For each option described 
here, you can use two ways to specify more than one group: 

• List them separated by commas 

• Specify a range 
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The available options are as follows: 


ENABLE=group-code[,...] 
DISABLE=group-code[,...] 

ENABLE=group-code[,...], 

DISABLE=group-code[,...] 


Gives your node access to the listed user groups. 
Prevents your node from accessing the listed 
groups. The listed groups were enabled 
previously. 

This option lets you enable certain groups and 
disable other groups in one command line: 
gives your node access to the groups listed 
with the ENABLE option and prevents your 
node from accessing the groups listed with 
the DISABLE option. Enclose both ENABLE 
and DISABLE in parentheses; for example, 
/GROUP=(ENABLE=(10,12), 

DISABLE=(l-30)). 


Description 


The SET NODE command, which is typically executed in the site-specific LAT 
configuration command procedure, LAT$SYSTARTUP.COM, allows you to specify 
such characteristics as: 


• Node name 

• Node identification 


• Service and user groups 


• Timing of service announcements 

• The maximum number of LAT sessions allowed simultaneously on the node 

• The maximum number of outgoing sessions and incoming interactive sessions 


Because LATCP commands change characteristics dynamically (that is, the 
commands take effect immediately), you can use the SET NODE command any 
time the LAT port driver is active. These changes remain in effect until the LAI 
port driver stops. To make sure the changes take effect when you start th e L ^1 
port driver again, edit LAT$SYSTARTUP.COM to include these changes Start 
the LAT port driver by invoking LAT$SYSTARTUP.COM. (See the OpenVMS 
System Manager’s Manual.) The OpenVMS System Manager’s Manual contains 
additional information about the LAT network in general and service nodes in 
particular. 


__Note- 

The SET NODE command must be executed first (after LTDRIVER is 
loaded and the LATACP is started) to ensure that other management 
commands execute properly thereafter. 


Examples 

1 LATCP> SET NODE DUKE /IDENT="NODE DUKE, SALES VMSCLUSTER" 

The SET NODE command in this example specifies node name DUKE for your 
local node. The identification string "NODE DUKE, SALES VMSCLUSTER is 
multicast from node DUKE. 
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2. LATCP> SET NODE /MULTICAST_TIMER=50 /GR0UPS=(ENABLE=(l-3,8,11),DISABLE=5) 

The SET NODE command in this example causes your local node to send 
multicast messages every 50 seconds to announce DUKE’s services to terminal 
servers The command also enables groups 1, 2, 3, 8, and 11 for access to the 
local node, and it disables group 5 from accessing the local node. Group 5 had 
been previously enabled. 

3. LATCP> SET NODE /C0NNECTI0NS=B0TH /USER_GR0UPS= (ENABLE= (24,121-127),DISABLED) 

The SET NODE command in this example sets up your local node to allow both 
incoming and outgoing connections. Users on your local node can access those 
service nodes belonging to user groups 24 and 121 through 127. Users cannot 
access service nodes in user group 0. 


4. 


LATCP> SET NODE /CIRCUIT_TIMER=80 /KEEPALIVE_TIMER=20 - 

_LATCP> /RETRANSMIT_LIMIT=20 /C0NNECTI0NS=B0TH /MULTICAST TIMER=60- 

_LATCP> /GR0UPS=(DISABLE=0,ENABLE=73) /SESSI0N_LIMIT=(OUTGOING=10,INCOMINGS) 


The SET NODE command in this example sets 
node DUKE. 


many characteristics at once for 


SET PORT 


Associates a logical port on the local node with a remote port on a terminal server 
that supports a device. Alternatively, it associates a logical port on the local 
node with a specific service. The service can be offered by a terminal server or 
associated with one or more dedicated ports on a remote LAT service node. 

You must have OPER privilege to use this command. 


Format 

SET PORT port-name 

Parameter 

port-name 

Specifies the name of the port. A port name must be in the form LTAn: where n 
is a unique number from 1 through 9999. 

-. Note__ 

You cannot use the CREATE PORT and SET PORT commands, along 

W c tS^ DCL command SET TERMINAL, to change the characteristics 
ot a DECserver port unless there is an existing LAT connection to that 
DECserver. 


Qualifiers 


/APPLICATION 

Specifies that a port on the local node is an application port, logically associated 
with a port on a terminal server or a dedicated port on another LAT service node. 
The terminal server port supports a device (for example, a printer). If the port is 
used to support a printer, the print queue is established in a startup command 
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procedure. See the OpenVMS System Manager’s Manual for a description of 
configuring remote printers on a terminal server. 

If you do not specify a port type, the default port type is APPLICATION. 


Specifies that a logical port on your local node is dedicated to an application 
service. The /DEDICATED qualifier requires the /SERVICE qualifier. 

To set up an application service for a logical port on a LAT service node: 

1. Create the service by specifying the CREATE SERVICE/APPLICATION 
command and then define the dedicated port by specifying the CREA1E 
PORT/DEDICATED command. You can include these commands in 
LAT$SYSTARTUP.COM. 


2 . 

3. 


Associate the dedicated ports with the service by specifying the SET PORT 
/DEDICATED/SERVICE command. 

Start the application program. Within the program, allocate dedicated ports 
with the same name as those defined in LAT$SYSTARTUP.COM. 


Specifies that a logical port on your local node is limited to a service in the same 
wav a port created using the /DEDICATED qualifier is dedicated to an application 
service. The difference is that ports created using the /LIMITED qualifier are 
under the control of the system login image (LOGINOUT.EXE) instead of an 
application program (a user who connects to a limited service and is assigned to a 
limited port receives the “Username:” prompt). 

Using the /LIMITED qualifier, you can create a limited number of ports and map 
them to a specific service offered by the host system. If users are logged hi to 
all of the limited ports for the service, no more connections are allowed to that 
service (terminal server users receive a “service in use” message). 


/LOG 

/NOLOG . - , , 

Specifies whether LATCP displays a message confirming that the port^s 

characteristics were modified. If you do not specify the /LOG or /NOLOG 
qualifier, the default is that no message will be displayed. 

/NODE=remote-node-name . 

Specifies the name of a terminal server (or a remote node that supports outgoing 
connections) to be logically associated with the specified application port on 
your node. The server supports a remote device. Note that you can set up an 
application port on your local node and associate the port with a dedicated port 
on a remote LAT service node. The remote port is dedicated to an application 
service. 

/PASSWORD=remote-password 

Specifies the password required to access a remote service that is logically 
associated with the specified application port. 

/PORT=remote-port-name 

Specifies the name of the remote port on a terminal server that supports a 
remote device, or specifies the name of a remote port dedicated to an application 
service on a remote LAT service node. In either case, the remote port is logical y 
associated with the specified application port on your local node. 
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/QUEUED 

/NOQUEUED 

Specifies queued or nonqueued access to the server port. A queued or nonqueued 

request is accepted by a terminal server if a remote port is free. If the remote 

port is busy and queuing is enabled on the terminal server, then the server 

queues the remote request. If you do not want your remote requests to be mienerf 
on the server, specify /NOQUEUED. requests to be queued 

Not specifying either the /QUEUED or /NOQUEUED qualifier results in 
access to the server port. This is the default Q ’" eued 

/SERVICE=service-name 

Specifies either of the following: 

associated thtT ™* 6 -fT* °, ffered at a termina l server port that will be 
associated with the specified application port (/APPLICATION) on the local 

' b6ing offered on a dedicated port 

mODE d Ind h /sSR , ?T e r 0 F a r T« te o£f f ed at a terminal port, use the 

jru. aad /SERVICE qualifiers. To specify a particular port for a service use 

forthli name?. ’ /SERVICE qualifiers - Ask the terminal server manager 

l7rr/ erV i Ce f ° r f particular application program to be offered locally on 
a dedicated port, use the /DEDICATED and /SERVICE qualifiers (The service 
must have been created with the CREATE SERVICE command.) Assign only one 

assfyned 0 “ ^ ^ ^ ^ SeVeral P ° rts Can have the *ame sendee 


Description 


rw nrl P ° RT C °T and a f 0ciates an application port on your local node with a 
port or service on a terminal server. 

To create a port, use one of the following methods: 

• Interactively enter the CREATE PORT command 

• Run a program that creates ports 

When you associate an application port with a service on a terminal server 
you allow access to any of the ports (printers) represented by that service (see 

mus ‘ have bMn created " ith 

The SET PORT command can also associate a dedicated port on the local node 

° ffered l0Cally - The service must aIread y exist (see 
Example 3). Note that you must use the /DEDICATED and /SERVICE qualifiers. 

SE 1 P0RT C ? mmand can also associate an application port on your local 

a tw^TT aPPhCatl0n /™ associated with one or more dedicated ports on 
a remote LAT service node. This service is offered to users on terminal servers 

on nodes that support outgoing connections (see Example 4). Note that the 
dedicated port must have been created with the CREATE PORT/DEDICATFD 
command. 

You can also set up the port as a limited port, using the /LIMITED qualifier. 
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Examples 

See the examples for the SHOW PORT command for displays that reflect the 
changes made by the following SET PORT command examples. 

1. LATCP> SET PORT LTA22: /APPLICATION /NODE=TS33EW /PORT=LN02 

The SET PORT command in this example sets up port LTA22: as an 
application port to be associated with the port named LN02^ the ternunal 
server named TS33EW. This command associates port LTA22 with a 
specific printer on the server. In the next example, the SET PORT comma 
associates a port with a set of printers (designated by the service name 
PRINTER) on a terminal server. 

2. LATCP> SET PORT LTA19: /APPLICATION /N0DE=TLAT1 /SERVICE=PRINTER /QUEUED 

The SET PORT command in this example shows how to associate a local 
logical port with a service (several printers) on a terminal se ™ ^he 
command associates the application port LTA19: with the service PRINTER 
on terminal server TLAT1. The service PRINTER can be associated with 
or more ports on TLAT1. The /QUEUED qualifier specifies that the server 
offering the service PRINTER can queue the remote connection request it all 
ports offering the service are in use. See the description of print operations in 
the OpenVMS System Manager’s Manual for information on setting up print 

queues. 

3 LATCP> SET PORT LTA21: /DEDICATED /SERVICE=GRAPHICS 

The SET PORT command in this example specifies that the application port 
LTA21: on the local service node offers the service GRAPHICS to users on 
terminal servers or on nodes that support outgoing connections. GRAPHIC 
is a particular utility or application program. 

4. LATCP> SET PORT MAIL_PORT /SERVICE=MAIL/NODE=RMNODE 

The SET PORT command in this example associates the port whose logical 
name is MAIL_PORT with the dedicated service MAIL on remote node 
RMNODE. The port logically named MAIL_PORT was created with ® 
CREATE PORT command (see Example 3 in the discussion of the CREA 
PORT command). The logical name could also have been created with an 
OoenVMS DCL ASSIGN or DEFINE command. On node RMNODE, a port 
must be dedicated to the service MAIL by using the SET PORT port-name 
/DEDICATED/SERVICE=MAIL command. 

5. $ LCP :== $ LATCP 

$ LCP CREATE SERVICE/LIMITED 0NLY_0NE 
$ LCP CREATE PORT/LIMITED LTA1234: 

$ LCP SET PORT LTA1234: / SERVICE=ONLY_ONE 

This series of commands, which includes the SET PORT command creates 
a limited service that allows only one user to log m to the system through 
that service. When a user connects to service ONLY_ONE by^responding ; to 
the terminal server prompt (Local>), the user is assigned port LTA1234 and 
then prompted for the user name. Any user who attempts to connect to the „ 
same service while LTA1234 has a user logged in receives the service in use 

message. 
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SET SERVICE 


Format 


Parameter 


Qualifiers 


SerIS 68 ? 6 characteristics of a locally offered service. You must 
nave UrRR privilege to use this command. 


SET SERVICE [service-name] 


service-name 

?s P ZftfL t ^ Se 7l Ce u h0Se CharaCteristiCS are t0 be modified - ^ a service name 
using'th^SET SSStZZZT " n ° de y °“ by 


/APPLICATION 

Sets up the service as an application service. An application service offers a 
specific application on the service node rather than all of the resources on the 

anTslrPOR?tmm\nt ,0ated P ° rt f< ”' by US “ g the CREATE P0RT 

/CONNECTIONS 

/NOCONNECTIONS 

Specifies whether a service offered by an OpenVMS system accepts incoming 
connections. If you use the /NOCONNECTIONS qualifier to disable incoming 
connections, users cannot connect to that service and receive instead the error 
message service is disabled.” 

By default, a service accepts incoming connections (/CONNECTIONS). 

/IDENTIFICATION[="identification-string"] 

Describes and identifies a service. Service nodes include the identification string 
in service announcements. A service node announces its services at regular 

uh™ ™ th the SET N0DE command. Entering the LATCP 

bHOW NODE command or the DECserver SHOW NODE command generates a 
display that includes this identification string. g 

By default, the identification string is the translation of SYS$ANNOUNCE A 

NODE command° UnCeS ^ SerViC6S at regular intervaIs established with the SET 

“ ore “ASCII characters in an identilication string (a 
SYS$ANNOUNCE longer than that will be truncated to the first 64 characters) 
Enclose the string in quotation marks (" "). 

/LIMITED 

Specifies that the service is a limited service, using devices assigned the limited 
c aractenstic and associated with (mapped to) this limited service. This qualifier 
is used in conjunction with the SET PORT /LIMITED command (see example). 
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/LOG 

Specifies whether or not LATCP displays a message confirming that the command 
was executed. If you do not specify the /LOG or /NOLOG qualifier, the defau is 
that no message will be displayed. 

/QUEUED 

/NOQUEUED 

Specifies whether a locally offered limited (/LIMITED) or application 
(/DEDICATED) service is allowed to have queued connections when all ports 
are busy (the default). If you specify /NOQUEUED, incoming connections will be 

rejected if all ports are busy. 

/STATIC_RATING=rating 

/NOSTATIC_RATING 

Enables or disables dynamic service ratings. A dynamic service rating means 
that a LAT algorithm calculates the availability of a service dynamically, based o 
the overall level of activity of the node that offers the service and the amount of 
memory. When a terminal server or node requests a connection to a service t 
is offered on two or more service nodes, the requesting node selects the service 
node with the highest (most favorable) service rating. This selection process is 
called load balancing. 

The dynamic service rating, which is the default, is usually adequate for efficient 
load balancing on the LAT network. However, when necessary, you can use the 
/STATIC_RATING qualifier to disable dynamic service ratings so that you can 
specify a static (fixed) rating. That static rating value does not change until the 
dynamic service rating is reenabled. 

Use the static rating to direct users away from or toward your node temporarily. 
Static ratings range from 0 to 255. Specify a low value to make the local service 
node less likely to be used; specify a high value to make the local service node 
more likely to be used. 

If you do not specify either the /STATIC.RATING or /NOSTATIC_RATING 
qualifier, the default is that the LAT software uses the dynamic service rating. 

Limited and application services do not rely exclusively on the dynamically 
calculated service rating. Instead, they use a portion of the dynamic rating: base 
on how many ports are available for the service. For example, if a limited service 
has 50 percent of its ports available, the dynamic service rating will be scaled, 
halved, and then added to 105. When ports are available, the rating will always 
be above the value 105. 

When all ports for a limited or application service are in use, the rating will be 
based on the scaled dynamic rating and the number of free queue slots on the 
local node. The rating will always be less then 90. 

This rating procedure for limited and application services follows the terminal 
server rating algorithm for services and available ports that the service o ers, 
while at the same time taking into account the availability of the node (which is 
the factor used to calculate the dynamic rating). 

If your system is licensed for a specific number of units (where only a fixed 
number of users can log in to the system regardless of how the login limit is set), 
then all dynamic ratings become 0 when all OpenVMS license units have been 
consumed. (This forces all node service ratings to the lowest possible value when 
logins are not possible because all OpenVMS license units have been consumed.) 
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Examples 


Note as well that the LAT software transmits a service announcement message 
when a user logs in to or out of the system. This allows the system to more 

quickly provide information about service rating changes that result from a login 
or logout operation. g 


Description 


The SET SERVICE command dynamically changes the characteristics of a service 
at you created previously (by interactively entering the CREATE SERVICE 
command or by running a program that created services). 


LATCP> SET SERVICE SALES /IDENT="SALES FORCE TIMESHARING SERVICES” 

T . he command in this example specifies a new identification 

string, SALES FORCE TIMESHARING SERVICES", for the service SALES 
This string is announced with the service SALES in the multicast messages ' 
sent by a service node. 


2. $ LCP :== $ LATCP 

$ LCP SET SERVICE/LIMITED ONLYJDNE 
$ LCP CREATE PORT/LIMITED LTA1234- 
$ LCP SET PORT LTA1234: /SERVICE=ONLY_ONE 

This senes of commands changes an existing service to a limited service that 
allows only one user to log in to the system through that service. When a 
user connects to service ONLY_ONE by responding to the terminal server 
prompt (Local>), the user is assigned port LTA1234 and then prompted for 

tt^oo^ 31116 ' Any US6r Wh ° attem P ts to connect to the same service while 
L1A1234 has a user logged in receives the “service in use” message. 


SHOW LINK 


Displays the status and LAT characteristics of links on the local node. 

Format 

SHOW LINK [link-name] 


Parameter 


link-name 

Specifies the name for a LAT data link. A link name can 
characters. 


have up to 


16 ASCII 


If you do not specify a link name, LATCP displays information about 
currently defined for the node. 


all links 


Qualifiers 

/BRIEF 

Displays the device name and state of the link. This is the default display. 
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Displays the device counters kept for the link. The numbers displayed represent 
the values recorded since the last time the counters were reset (when the node 
first started or when the ZERO COUNTERS command was used). 

Do not use the /BRIEF or /FULL qualifier with this qualifier. 

Table 13-2 lists and describes counters common to both CSMA/CD (carrier sense, 
multiple access with collision detect) and FDDI (fiber distributed data interface) 

links. 


Table 13—2 Counters Common to CSMA/CD and FDDI Links 


Counter 

Messages received 
Multicast messages received 
Bytes received 
Multicast bytes received 
System buffer unavailable 
Unrecognized destination 

Messages sent 
Multicast messages sent 

Bytes sent 

Multicast bytes sent 

User buffer unavailable 

Data overrun 


Description 

The total number of messages received over the 

link. 

The total number of multicast messages received 
over the link. 

The total number of bytes of information received 
over the link. 

The total number of multicast bytes received over 
the link. 

The total number of times no system buffer was 
available for an incoming frame. 

The total number of times a frame was discarded 
because there was no portal with the protocol 
enabled. This count includes frames received for 
the physical address only. 

The total number of messages sent over the link. 
The total number of multicast messages sent 
over the link. 

The total number of bytes of information sent 
over the link. 

The total number of bytes of multicast messages 
sent over the link. 

The total number of times no user buffer was 
available for an incoming frame that passed all 
filtering. 

The total number of bytes lost on the link’s 
device because the local node’s input buffers 
were full. A nonzero value can indicate noisy 
lines, a bad device, a busy or poorly tuned 
system (not enough resources allocated), or a 
hardware problem with another device on the 
LAN connection. 


Table 13-3 lists and describes receive errors common to both CSMA/CD and 
FDDI links. These errors, which are included in the display generated by the 
SHOW LINK/COUNTERS command, are represented by flags that indicate the 

error has occurred. 
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Table 13-3 
Flag 


Receive Errors Common to CSMA/CD and FDDI Links 

Description 


Block check error 

Framing error 
Frame too long 
Frame status error 

Frame length error 


CRC error in packet(s) received. 

Received frame(s) ended incorrectly. 

Frame(s) received longer than length limits. 

CRC error on ring noticed by local FDDI station 
(FDDI only). 

Frame length too short (FDDI only). 


Fnm r 3 l 4 “2? 3nd describes transmit errors common to both CSMA/CD and 

sSowun'JcSuntfrs ar l included in the display generated * the 

error has ^rey ’ “* represented * ^ that indicate the 


Table 13-4 Transmit Errors Common to CSMA/CD and FDDI Links 

Flag 

Description 

Excessive collisions 

Frame(s) failed to transmit because the collision 

limit of 16 was reached (CSMA/CD only). 

Carrier check failures 

Indicates transceiver problem or short circuit in 
cable. 

Short circuit 

Short circuit in cable. 

Open circuit 

Open circuit in cable. 

Frame too long 

Frame(s) too long. Indicates a transmission 
problem in one of the portals using the link. 

Remote failure to defer 

A remote station failed to defer frame(s) 
transmission. Could indicate a misconfigured 
network. 

Transmit underrun 

Transmission of a frame was too slow. Indicates 
a hardware controller error. 

Transmit failure 

Frame(s) failed to transmit. 


Table 13-5 lists and describes link counters specific to CSMA/CD only. 


Table 13—5 CSMA/CD Counters 
Counter Description 

Transmit CDC failure The total number of carrier detect check errors, 

that is, the number of times the local node failed 
to detect that another Ethernet station was 
already transmitting when the local node began 
transmitting. 

(continued on next page) 
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Table 13-5 (Cont.) CSMA/CD Counters 

Counter Description 


Messages transmitted: 


Single collision— The total number of times 

a frame was successfully transmitted on the 
second attempt after a normal collision on the 
first attempt. 

Multiple collision— The total number of times 
a frame was successfully transmitted on the 
third or later attempt after normal collisions on 
previous attempts. 

Initially deferred— The total number of times 
a frame transmission was deferred on its first 
attempt. This counter is used to measure 
Ethernet contention with no collisions. 


Table 13-6 lists and describes link counters specific to FDDI only. 


Table 13-6 FDDI Counters 

Counter _ 

Ring initializations initiated 


Ring initializations received 
Directed beacons received 

Connections completed 

Duplicate tokens detected 
Ring purge errors 

LCT rejects 

Elasticity buffer errors 


Description 

The total number of times a ring 

reinitialization was initiated by the 
link. 

The total number of times a ring 
reinitialization was initiated by some 
other link. 

The number of times the link detected the 
directed beacon process. Each invocation 
of the directed beacon process is counted 
only once. 

The number of times the station 
successfully connected to the 
concentrator. 

The number of times a duplicate token 
was detected on the link. 

The number of times the ring purger 
received a token while still in the ring 
purge state. 

Link Confidence Test rejects. Indicates 
a problem with communication between 
station and concentrator. 

Elasticity buffer function errors. 

Indicates a station on the ring with a 
transmit clock out of tolerance. 

(continued on next page) 
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Description 


Examples 


Table 13-6 (Cont.) FODI Counters 


Counter 

Description 

MAC error count 

The number of times the MAC (Media 
Access Control) changed the E indicator 
in a frame from R to S. 

Traces initiated 

The number of times the PC-trace process 
was initiated by the link. 

Traces received 

The number of times the link was 
requested to perform the PC-trace 
process. 

Ring beacons initiated 

The number of times the ring beacon 
process was initiated by the link. 

Link errors 

The number of times the Link Error 
Monitor (LEM) detected an error in 
a received message. Slow counts are 
normal. 

Duplicate address test failures 

The number of times the link address was 
a duplicate. 

FCI strip errors 

The number of times a Frame Content 
Independent Strip operation was 
terminated by receipt of a token. 

LEM rejects 

The number of times excessive LEM 
errors were encountered. 

MAC frame count 

The total number of frames (other than 
tokens) seen by the link 

MAC lost count 

The total number of times a frame (other 
than a token) was improperly terminated. 


/FULL 


Duplays the device name, state, and datalink address of the link and indicates 
whether the DECnet address is enabled. 


Displays information about the specified link or all links if you do not specify a 
link Depending on the qualifier you use with the SHOW LINK command you 

can display a link’s device name, state, LAT datalink address, DECnet address 
or counters. ’ 


1. LATCP> SHOW LINK/FULL NETWORK_A 


The SHOW LINK command in this example produces the following display of 
information about link NETWORK_A: 


Link Name: NETW0RK_A 

Device Name: _ESA7: 
Link State: On 


Datalink Address: 08-00-2B-10-12-E3 
DECnet Address: Disabled 


The display in this example gives the device name of link NETWORK_A and 
the device’s hardware address. The link is in the On state. 
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2 . 


LATCP> SHOW LINK LINK_A/COUNTERS 

The SHOW LINK command in this example produces the following display of 
counters for link LINK_A: 


Link Name: 
Device Name: 


LINK_A 

ETA6: 


Seconds Since Zeroed: 

65535 

Messages Received: 

18582254 

Multicast Msgs Received: 

15096805 

Bytes Received: 

1994694325 

Multicast Bytes Received: 

1528077909 

System Buffer Unavailable: 

8724 

Unrecognized Destination: 

0 

Receive Errors - 


Block Check Error: 

No 

Framing Error: 

No 

Frame Too Long: 

No 

Frame Status Error: 

No 

Frame Length Error: 

Yes 

CSMACD Specific Counters 


Transmit CDC Failure: 

0 

Messages Transmitted - 


Single Collision: 

43731 

Multiple Collisions: 

73252 

Initially Deferred: 

164508 


6269 
0 


Messages Sent: 3550507 
Multicast Msgs Sent: 413178 
Bytes Sent: 290838585 
Multicast Bytes Sent: 32637472 
User Buffer Unavailable: 

Data Overrun: 

Transmit Errors - 

Excessive Collisions: No 
Carrier Check Failure: No 
Short Circuit: No 
Open Circuit: No 
Frame Too Long: No 
Remote Failure To Defer: No 
Transmit Underrun: No 
Transmit Failure: No 


SHOW NODE 


Format 


Displays the status and LAT characteristics of a node. 


SHOW NODE [node-name] 


Parameter 


Qualifiers 


node-name . „ j 

Specifies the name of the node for which information is displayed. If you do not 
specify a node name, LATCP displays information about the local node. 

You can also specify any valid wildcard for this parameter For example, the 
SHOW NODE A* command displays the status and characteristics of all nodes 
that begin with the letter A. 


Displays information about all nodes known to your local node. When you use 
this qualifier, specify the /FULL or /BRIEF qualifier as well. If you do not specify 
either the /FULL or /BRIEF qualifier, the default display will contain the node 
status and identification string (the display generated by the /BRIEF qualifier). 
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/BRIEF 


Displays the node status and identification 
you specify the /ALL qualifier. 


string. This is the default 


display if 


/COUNTERS 

Displays the counters kept for the node. Do not use the /BRIEF or /FULL 


Table 13—7 LAT Node Counters 


Counter 

Messages received 


Messages transmitted 


Slots received 


Slots transmitted 


Bytes received 


Bytes transmitted 


Multicast bytes received 
Multicast bytes sent 


Description 

The total number of LAT messages received by 

the local node. If you specify a remote node with 
the SHOW NODE command, the number of LAT 
messages received from that remote node. 

The total number of LAT messages transmitted 
by the local node. If you specify a remote node 
with the SHOW NODE command, the number of 
LAT messages transmitted to that remote node. 
The total number of LAT slots received by the 
local node. If you specify a remote node with 
the SHOW NODE command, the number of 
slots received from that remote node. A slot is 
a message segment that contains information 
corresponding to a single session. 

The total number of LAT slots transmitted by 
the local node. If you specify a remote node with 
the SHOW NODE command, the number of slots 
transmitted to that remote node. 

The total number of bytes of LAT information 
received by the local node. If you specify a 
remote node with the SHOW NODE command, 
the number of bytes received from that remote 
node. 

The total number of bytes of LAT information 
transmitted by the local node. If you specify a 
remote node with the SHOW NODE command, 
the number of bytes transmitted to that remote 
node. 

The total number of LAT multicast bytes received 
by the local node. 

The total number of LAT multicast bytes sent by 
the local node. 


Multicast messages received 
Multicast messages sent 


The total number of LAT multicast messages 
received by the local node. 

The total number of LAT multicast messages 
sent by the local node. 


(continued on next page) 
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Table 13-7 (Cont.) LAT Node Counters 

Counter Description 


No transmit buffer 
Multicast messages lost 

Multicast send failures 

Controller errors 

Last controller error 
Multiple node addresses 

Duplicates received 

Messages retransmitted 

Illegal messages received 


Illegal slots received 

Solicitations accepted 


The total number of times no buffer was 

available on the local node for transmission. 

The total number of times LTDRIVER failed to 
process an inbound multicast message because of 
failed communication with the LATACR 
The total number of times LTDRIVER failed 
to send a multicast message because of failed 
communication with the LATACP. 

The total number of times LTDRIVER failed to 
communicate with the data link controller driver. 

The most recent controller error. 

The total number of times that a node announced 
itself with a physical address different from that 
in a previous announcement. 

The total number of duplicate messages received 
by the local node. If you specify a remote 
node with the SHOW NODE command, the 
number of duplicate messages received from that 
remote node. This counter can indicate a system 
slowdown. 

The total number of LAT messages that the 
local node retransmitted because they were not 
acknowledged by terminal servers (or nodes that 
support outgoing connections). If you specify a 
remote node with the SHOW NODE command, 
the number of messages retransmitted to that 
remote node. 

The total number of invalidly formatted LAT 
messages received by the local node. If you 
specify a remote node with the SHOW NODE 
command, the number of invalidly formatted 
messages the local node received from that 
remote node. Illegal messages are grouped into 
several types of protocol errors, which are listed 
at the end of this table. 

The total number of invalidly formatted LAT 
slots received by the local node. If you specify a 
remote node with the SHOW NODE command, 
the number of invalidly formatted slots the local 
node received from that remote node. 

The total number of times a remote node 
accepted solicitations from the local node. If you 
specify a remote node with the SHOW NODE 
command, the number of accepted solicitations 
by that remote node. 

(continued on next page) 
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Table 13 7 (Cont.) LAT Node Counters 


Counter 

Description 

Solicitations rejected 

The total number of times a remote node rejected 
solicitation from the local node. If you specify a 
remote node with the SHOW NODE command, 
the number of rejected solicitations by that 
remote node. 

Solicitation failures 

The total number of times solicitations by the 
local node received no response. 

Transmit errors 

The total number of times the data link failed to 
transmit a LAT message. 

Last transmit error 

The most recent transmit error. 

Virtual circuit timeouts 

The total number of times a LAT circuit to 
another node timed out, indicating that the 
remote node failed to send a valid message in the 
required time span. If you specify a remote node 
with the SHOW NODE command, the number of 
times the local node timed out from a connection 
to that remote node. 

Discarded output bytes 

The total number of data bytes that were 
discarded because of an overflow of an internal 
buffer before the data could be output to an LTA 
device. 

User data lost 

The total number of times LTDRIVER failed to 
allocate resources to buffer session data. User 
data is lost and the session is stopped. 

Resource errors 

The number of times LTDRIVER was unable to 
allocate system resources. 

Incoming solicits accepted 

The total number of times the local node accepted 
solicitations from other nodes. 

Incoming solicits rejected 

The total number of times the local node rejected 
solicitations from other nodes. 


!Z!!!Tr err ° rS ‘ ha ‘ are f° unted as m< *al messages are as follows. These 
protocol error messages are displayed if their associated counter is greater than 


• Invalid message type received 

• Invalid start message received 

Invalid sequence number received in start message 

• Zero-node index received 

• Node circuit index out of range 

• Node circuit sequence invalid 

• Node circuit index no longer valid 

• Circuit was forced to halt 

• Invalid server slot index 
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• Invalid node slot index 

• Invalid credit field or too many credits used 

• Repeat creation of slot by server 

• Repeat disconnection of slot by master 


Disolavs the node’s status, identification string, LAT protocol version, and the 
values of the node’s characteristics. This is the default except when you specify 

the /ALL qualifier. 

Displays statistical information for parameters such as the number of 
circuits sessions, and incoming queue entries. For each parameter, the display 
shows the current value, the highest value recorded, and the maximum value 

allowed. 

Note that you can specify the /STATUS qualifier with the SHOW NODE command 
to display information about the local node only (for example, the command 
SHOW NODE /STATUS FOREIGN.NODE is not supported). 


Description 


This command displays information about a specified node or, if Y ou ^ o n ^ T 
specify a node name, about your local node. With the /ALL qualifier, the SHOW 
NODE command displays information about all nodes known ° J™ r t g 

Depending on the qualifiers you use, you can display node counters node status 
the node identification string, the LAT protocol version running on the node, and 
the values set for the node’s characteristics. 


Examples 


1. LATCP> SHOW NODE/FULL 

The SHOW NODE command in this example produces the following display 
of information about the local node. 


Node Name: 
Node State: 
Node Ident: 


LTC 

On 

LTC 


LAT Protocol Version: 5.2 


Engineering Development 


Incoming Connections: Enabled 
Outgoing Connections: Enabled 
Service Responder: Disabled 

Circuit Timer (msec): 80 

Retransmit Limit (msg): 20 

Multicast Timer (sec): 20 

Maximum Unit Number: 9999 


Incoming Session Limit: 
Outgoing Session Limit: 

Keepalive Timer (sec): 
Node Limit (nodes): 

CPU Rating: 


None 

None 

20 

None 

8 


User Groups: 
Service Groups: 

Service Name 
LTVMS 


7-9, 13, 23, 40, 43, 45, 66, 72-73, 89, 120 127, 248 255 

Status Rating Identification 

Available 31 D 


This display indicates that the local node LTC is in the On state, which 
means iVconnections can be created on the node. LTC 
5 2 of the LAT protocol. The identification of the node is LTC - Engineen g 
Development". Because this is the local node, the display does not give the 
address of a LAN device. Use the SHOW LINK command to find addresses 
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of devices on the local node. The display for the status of remote nodes, as 
shown in Example 2, gives the Ethernet address of that node. 

Both incoming and outgoing connections can be made on node LTC the 
number of sessions is unlimited. The display indicates the values of various 
timers and lists the groups that are enabled. Users on the local node can 
access service nodes belonging to user groups 43 and 73. Locally offered 
services can be accessed by nodes belonging to the service groups listed. 

The display indicates that the CPU rating of the local node is 8. The display 
shows that the node offers a service named LTVMS. This service is available 
and its rating is 31 D (dynamic). (An S would indicate the rating is static.) 

LATCP> SHOW NODE/FULL RWWUP 

T u 6 f^i° W N0DE comm and in this example produces the following display 
about the remote node RWWUP: y 

Node Name: RWWUP 
Node State: Reachable 
Node Ident: 

Incoming Connections: Enabled 

Circuit Timer (msec): 80 

Multicast Timer (sec): 20 

Service Groups: 7, 13, 42-43, 45, 66, 70-72, 75-82, 88-89 


LAT Protocol Version: 5.2 

Address: AA-00-04-00-11-10 


Service Name 

NAC 

SYSMGR 


Status Rating Identification 

Available 28 

Available 28 


This display indicates that remote node RWWUP is reachable and runs 
ersion 5 2 of the LAT protocol. The display includes the Ethernet address 
of node RWWUP. Because incoming connections are enabled, you can connect 
to a service on node RWWUP, provided that your node belongs to one of the 
service groups listed in the display. 

Node RWWUP offers two services: NAC and SYSMGR. Both are available. 

3. LATCP> SHOW NODE/ALL/BRIEF 

The SHOW NODE command in this example produces the following display 
about all nodes known to the local node: 


Node Name 

Status 

ABLAN 

Reachable 

ASKWEN 

Reachable 

CHUNK 

Reachable 

UTOO 

On 

VULCUN 

Reachable 

ZENX 

Reachable 


Identification 

Unauthorized access is prohibited. 
A member of the MAIN VMScluster 


Can be healthy at the Center 

Beam me up 

ZENX 


The SHOW NODE command in this example indicates the status (whether 
a node is reachable) and identification of all nodes known to the local node. 
Note also that the display includes the status of the local node UTOO The 
status can be either On, Off, or Shut. Here it is On. 
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4. $ LCP :== $ LATCP 

$ LCP SHOW NODE /STATUS 

The SHOW NODE /STATUS in this example produces the following display: 

Node Name: N0DE1 LAT Protocol Version: 5.2 

Node State: On 

Node Ident: Test system 

Current Highest Maximum 


1 2 1023 

1 6 260865 

0 0 24 

0 1 32767 

0 7 500 

0 2 250 

1 2 255 

188 194 N/A 

166 172 N/A 

Discarded Nodes: 0 


Active Circuits: 

Connected Sessions:_ 
Incoming Queue Entries: 
Outgoing Queue Entries: 
Unprocessed Announcements: 
Unprocessed Solicits: 

Local Services: 

Available Services: 
Reachable Nodes: 


SHOW PORT 

Displays the status and LAT characteristics of ports on the local node. 


Format 

SHOW PORT [port-name] 

Parameter 

SpecifieTthe name of the port for which information is displayed. If you do not 
specify a port name, the SHOW PORT command displays the characteristics for 

all LTAn: ports on a node. 

Do not use the /APPLICATION, /DEDICATED, /FORWARD, or /INTERACTIVE 
qualifiers with a specific port name. 

In addition do not use the /LIMITED qualifier with a specific port name. 


Qualifiers 

/APPLICATION 

Generates a display of all application ports. 


Displays port type, port status, and the remote node name, port, and service 
associated with the port. This is the default if you do not specify a port name 
with the SHOW PORT command. 


/COUNTERS 

Displays the counters kept for the port, 
qualifiers with this qualifier. 


Do not use the /BRIEF or /FULL 


/DEDICATED 

Generates a display of all dedicated ports. 


13-52 










LATCP 
SHOW PORT 


Description 


Examples 


/FORWARD 

locai e LATm fl diSPlay L t T P ° rtS USed f ° r 6ither out S° in g L AT connections or 
local LAI management functions. 

/FULL 

Displays the following information: 

• Port type 

• Port status 

Target port name, node name, and service name associated with the port 
^currently acti^ 6 ' ^ ^ Service associated with the port if a connection 

For more information, see the description of the SHOW PORT/FULL example. 

/INTERACTIVE 

Generates a display of all LAT ports used for incoming interactive connections. 

/LIMITED 

Generates a display of all limited LTA devices on the system (previously 
established with the CREATE PORT /LIMITED or SET PORT /LIMITED 
command). 


If a port is an application port, the display lists the remote node name, remote 
port name, and remote service name that you specified in the SET PORT 
command. 

the ^ lists the 8e ™ e name that y ° a "-"w 

If LATCP shows the port as Interactive in the display, a user on a terminal server 
or on a node that supports outgoing LAT connections is currently using the port. 

For all ports with active sessions, the remote node sends its node name and port 
name to your local node. These names are listed in the display. 


1. LATCP> SHOW PORT /FULL 

The SHOW PORT command in this example produces the following type of 
display. The display reflects the characteristics set by the command examples 
given with the SET PORT command. 


Local Port Name: _LTA16: 
Local Port State: Inactive 
Connected Link: 


Local Port Type: Forward 


Target Port Name: Actual Port Name: 

Target Node Name: LATCP$MGMT_PORT Actual Node Name: 

Target Service Name: Actual Service Name: 


Local Port Name: _LTA17: 
Local Port State: Active 
Connected Link: LAT$LINK 


Local Port Type: Interactive 


13-53 







LATCP 
SHOW PORT 


Target Port Name: 

Target Node Name: 

Target Service Name: 

Actual Port Name: P0RT_1 

Actual Node Name: MY_DS200_SERVER 

Actual Service Name: 

Local Port Name: _LTA19: 

Local Port State: Active 

Connected Link: LAT$LINK 

Local Port Type: Application (Queued) 

Target Port Name: 

Target Node Name: TLATl 

Target Service Name: PRINTER 

Actual Port Name: 

Actual Node Name: TLATl 

Actual Service Name: PRINTER 

Local Port Name: _LTA21: 

Local Port State: Inactive 
Connected Link: 

Local Port Type: Dedicated 

Target Port Name: 

Target Node Name: 

Target Service Name: GRAPHICS 

Actual Port Name: 

Actual Node Name: 

Actual Service Name: 

Local Port Name: _LTA22: 

Local Port State: Active 
Connected Link: LAT$LINK 

Local Port Type: Application (Queued) 

Target Port Name: LN02 

Target Node Name: TS33EW 

Target Service Name: 

Actual Port Name: LN02 

Actual Node Name: TS33EW 

Actual Service Name: 


The display in this example shows information about all the ports on the local 
node. The display shows information for each of the four types of ports: 


Forward: a port used for outgoing LAT connections or for executing loca 
management functions and LATCP commands. Port LTA16: is a forward 
port. The display shows that the port is currently inactive—no current 
LAT connection exists. The target node name of LATCP$MGMT_PORT 
indicates that LATCP is using this port to execute the LATCP commands 
entered by the user. If the display listed a node and service name, it 
wnulrl mfian that the port is being used for an outgoing connection. 


• Interactive: a port created as a result of an incoming LAT connection 
request from another node or terminal server. Port LTA17: is an 
interactive port connected with port PORT_l on the terminal server 
MY_DS200_SERVER. 


• Application: a port used for solicited connections to devices on terminal 
servers or to application services on remote LAT service nodes. Port 
LTA22- is an application port. The port maps to port LN02 (a printer) 
on a terminal server node TS33EW. The display indicates that server 
TS33EW queues connection requests from the local node. Port LTA19: 
is also an application port. The port maps to the service PRINTER on 
terminal server TLAT1. 


• Dedicated: a port dedicated to a local application service. Port LTA21: is 
dedicated to the service GRAPHICS. 


The target port name, target node name, and target service name are the 
names specified with the SET PORT command. They are passed to the 
remote node or terminal server when the connection request is made. 
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The actual port name, actual node name, and actual service name are the 
names returned by the remote node when it accepts the connection request. 
WTPn a pT dlffer fr °m the corresponding target names (specified with the 
bET PORT command) if the remote node translates the names. For example 
terminal servers that accept connections to LAT service names usually return 
the name of the port to which the connection was actually directed. 

2. LATCP> SHOW PORT LTA1 /COUNTERS 

The SH° W PORT/COUNTERS command in this example produces a display 
that lists counter information for the LTA1 device. 


Port Name: _LTA1: 

Seconds Since Zeroed: 66 

Remote Accesses: q 

Local Accesses: q 

Bytes Transmitted: q 

Bytes Received: q 

Solicitations Accepted: i 

Solicitations Rejected: i 

Incoming Solicits Accepted: 0 

Incoming Solicits Rejected: 0 

Last disconnect reason code: 18 

(%LAT-F-LRJDELETED, queue entry deleted by server) 


Framing Errors: 
Parity Errors: 
Data Overruns: 
Password Failures: 


SHOW QUEUE ENTRY 


Displays information about requests, or entries, queued on the local node. 

Format 

SHOW QUEUE_ENTRY [queue-entry-id] 

Parameter 

queue-entry-id 

Specifies the identification number (ID) of the queued entry for which information 
is displayed. If you do not specify a value for this parameter, information about 
all queued entries is displayed. 

Qualifiers 

/BRIEF 

Displays the following information about the queued entries: 

• Position 

• Entry ID 

• Source node 

• Service 

• Port name 

(This is the default display.) 
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Description 


Examples 


In addition to the information displayed by the /BRIEF qualifier, the /FULL 
qualifier provides the following information for each node. 

• Node queue position 

• Service queue position 

• Node address 

• Soliciting Link 


The SHOW QUEUE_ENTRY command displays information about requests or 
entries queued on the local node. You can display information about a specific 
entry by including the queue entry ID on the command line or you can display 
information about all entries (the default). Use the DELETE QUEUE.ENTRY 
command to delete specific entries from the queue. 


l. 


LATCP> SHOW QUEUE_ENTRY 

The SHOW QUEUE.ENTRY command in this example produces the following 
type of display. 

Position Entry ID Source Node Service Port Name 

1 79 EC N0DE1 LAT_LIMITED 

2 7AEC N0DE2 LAT_LIMITED 

3 7CEC NODE3 LAT_LIMITED 


2 . 


LATCP> SHOW QUEUE_ENTRY/FULL 

The SHOW QUEUE.ENTRY/FULL command in this example produces the 
following type of display. 


Entry ID: 7AEC 

Node Queue Position: . 1 

Service Queue Position: 1 

Target Port: 

Target Service: LAT_LIMITED 
Soliciting Link: LAT$LINK 


Remote Node: N0DE1 

Address: 08-00-2B-0A-A0-A0 


Entry ID: 7CEC 

Node Queue Position: 2 

Service Queue Position: 2 

Target Port: 

Target Service: LAT_LIMITED 
Soliciting Link: LAT$LINK 


Remote Node: N0DE2 

Address: AA-00-04-00-37-DD 
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SHOW SERVICE 


Displays the status and LAT characteristics of LAT services known to the local 
node. 

Format 

SHOW SERVICE [service-name] 

Parameters 

service-name 

Specifies the name of the service for which information will be displayed. If you 
do not specify a service name, LATCP displays information about all services 
known to the node. 

You can also specify any valid wildcard for this parameter. For example, the 
SHOW SERVICE LAT_* command displays the status and characteristics of all 
services that begin with the LAT_ prefix. 

Qualifiers 

/BRIEF 

Displays the status and identification string of the service. 

/COUNTERS 

Displays the counters kept for the service. Do not use the /BRIEF or /FULL 
qualifier with this qualifier. The following table lists and describes the counters; 


Counter 

Description 

Remote Counters 

Connections attempted 

The total number of times the local node 
attempted to connect to the service offered on 
a remote node. 

Connections completed 

The total number of times the local node 
successfully connected to the service offered on 
a remote node. 

Local Counters 

Connections accepted 

The total number of times the local node accepted 
a connection request from a remote node to a 
locally offered service. 

Connections rejected 

The total number of times the local node rejected a 
connection request from a remote node to a locally 
offered service. 

Password failures 

The total number of connect requests to the service 
which were rejected due to password violation 
errors. 
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/FULL 

Displays the status, identification string, and type of service, and the values set 
for service characteristics. This qualifier also displays the status of all service 
nodes offering the service. 

/LOCAL 

Displays information about services offered by the local node only. You can use 
this qualifier with the /BRIEF, /COUNTERS, or /FULL qualifier. 

Description 

T his command displays information about services. If you do not specify a service 
name, the command displays information about all services known to your local 
node. If you do not specify a service name but specify the /LOCAL qualifier, the 
command displays information about all services offered by your local node. 

Depending on whether you use the /BRIEF, /COUNTERS, or /FULL qualifier, you 
can display the status, identification string, and type of service, the status of all 
service nodes offering the service, the values set for service characteristics, and 
service counters. 

Examples 

1. LATCP> SHOW SERVICE NODEl /FULL 

The SHOW SERVICE command in this example produces the following 
display of information about service NODEl. This service is offered by the 
local node. 


Service Name: 

NODEl 


Service Type: General 

Service Status: 

Available 


Connections: Enabled 

Service Password: 

: Enabled 


Queueing: N/A 

Service Ident: 

NODEl - Test 

system 


Node Name 

Status 

Rating 

Identification 

LAV 

On 

31 D 


LATP 

Reachable 

48 


LITTN 

Reachable 

37 


LTDRV 

Reachable 

82 



The display in this example indicates that the locally offered service NODEl 
is available and its service type is general, meaning that it is a general 
timesharing service (in contrast to a dedicated application service). The 
display also lists the status of all the nodes that offer the service. The local 
node is LAV. The status of the local node can be either On, Off, or Shut. Here 
node LAV’S status is On. The status of the other nodes indicates whether they 
are reachable. The display lists the ratings of each service node, indicating 
their relative capacity to accept new connections. The D next to the locally 
offered service indicates that node LAV computes its rating dynamically. An 
S would indicate that the node’s rating was set permanently by the node’s 
system manager. 
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2. LATCP> SHOW SERVICE OFFICE/FULL 

The SHOW SERVICE command in this example produces the following 

display of information about the service OFFICE, which is offered by a remote 
node: 

Service Name: OFFICE 

Service Status: Available 
Service Ident: 

Node Name Status Rating Identification 

BURGIL Reachable 121 

DARWIN Reachable 43 

The display in this example indicates that the service is available. The 
display also indicates the status and other information about the nodes that 
offer the service, BURGIL and DARWIN. 


SPAWN 


Creates a subprocess, enabling you to execute DCL commands without 
terminating your LATCP session. The LATCP SPAWN command is similar to 
the DCL SPAWN command. 

To return to your LATCP session, either log out of the subprocess by entering 
the DCL LOGOUT command, or use the DCL ATTACH command to attach your 
terminal to the process running LATCP. 

Format 

SPAWN [DCL-command] 

Parameter 

DCL-command 

Specifies a DCL command. If you specify a DCL command, LATCP executes the 
command in a subprocess. Control returns to LATCP when the DCL command 
terminates. 

If you do not specify a DCL command, LATCP creates a subprocess and you can 
then enter DCL commands. You can continue your LATCP session by logging out 
of the spawned subprocess or by attaching to the parent process with the DCL 
ATTACH command. 


Description 

The SPAWN command acts exactly like the DCL SPAWN command. You can 
enter DCL commands (such as to create print queues, change the protection of a 
device, answer mail, and so forth) without ending your LATCP session. 

You cannot use this command to gain access to DCL if you are running LATCP 
from a captive account. 
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Example 

LATCP> SPAWN 
$ 

The SPAWN command in this example creates a subprocess at DCL level. You 
can now enter DCL commands. Log out or enter the DCL ATTACH command to 
return to the LATCP prompt. 


ZERO COUNTERS 

Resets the link, node, and service counters maintained by the local node. You 
must have OPER privilege to use this command. 

Format 

ZERO COUNTERS 

Qualifiers 

/LOG 

/NOLOG 

Specifies whether LATCP displays a message confirming that the counters were 
reset. If you do not specify the /LOG or /NOLOG qualifier, the default is that no 
message will be displayed. 

/LINK[=link-name] 

Specifies the link (on your local node) for which you want counters reset. If you 
do not specify a link name, LATCP zeroes counters for the link LAT$LINK. 

/NODE[=node-name] 

Specifies the node for which you want counters reset. If you do not specify a node 
name, LATCP zeroes the counters for your local node. 

/PORT=port-name 

Specifies the port (on your local node) for which you want counters reset. 

/SERVICE=service-name 

Specifies the service (on your local node) for which you want counters reset. 

Description 

This command resets counters. You can specify whether you want to reset link, 
node, or service counters. You must specify either /LINK, /NODE, or /SERVICE. 
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Example 


LATCP> ZERO COUNTERS/SERVICE=LTVM 
LATCP> SHOW SERVICE LTVM /COUNTERS 

Service Name: LTVM 

Seconds Since Zeroed: 9 

Connections Attempted: 0 

Connections Completed: 0 

Password Failures: o 


Connections Accepted: 
Connections Rejected: 


The ZERO COUNTERS command in this example resets the counters kept for 
service LTVM. The display produced by the SHOW SERVICE command shows 
how the ZERO COUNTERS command reset the counters to zero. 
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LMCP Description 


The Log Manager Control Program (LMCP) utility 
transaction logs used by DECdtm services. 


creates and manages the 


Caution 


Some LMCP commands can corrupt data. 

See the OpenVMS System Manager’s Manual to understand the 
for using LMCP and how to use it safely. 


reasons 
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LMCP Usage Summary 

LMCP lets you create and manage the transaction logs used by Digital s 
distributed transaction manager, DECdtm services. 


Format 

RUN SYS$SYSTEM:LMCP 


Usage Summary 

To invoke LMCP, enter RUN SYS$SYSTEM:LMCP at the DCL command prompt. 
At the LMCP> prompt, you can enter any of the LMCP commands described in 

the following section. 

To exit from LMCP, enter the EXIT command at the LMCP> prompt, or press 


Ctrl/Z. 
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LMCP Commands 

Table 14-1 summarizes the LMCP commands. 

Table 14-1 LMCP Commands 


Command 

Description 

CLOSE LOG 

Closes the transaction log and stops the TP SERVER process 

CONVERT LOG 

Creates a new transaction log and copies records from an 
existing transaction log to the new transaction log 

CREATE LOG 

Creates a new transaction log 

DUMP 

Displays the contents of a transaction log 

EXIT 

Exits LMCP 

HELP 

Gives help on LMCP commands 

REPAIR 

Changes the state of transactions 

SHOW LOG 

Displays information about transaction logs 


CLOSE LOG - 

Closes the transaction log and stops the TPJ3ERVER process. 

Requires the SYSNAM privilege. 

Format 

CLOSE LOG 

Description 

Use the CLOSE LOG command to: 

• Close the transaction log of the local node. 

• Stop the TP_SERVER process on the local node. 

The CLOSE LOG command fails if the node is currently executing transactions. 

CONVERT LOG ~ 


Creates a new transaction log and copies records from an existing transaction log 
to the new one. & 

Use the CONVERT LOG command when you want to move a transaction log or 

rrmncrck lfc civn 
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CONVERT LOG 


Format 

Parameters 


Qualifiers 


Caution 


If a node already has a transaction log, using the CONVERT LOG 
command to create a new one can corrupt data. See the OpenVMS 
System Manager’s Manual for information on how to use the CONVLK1 

LOG command safely. 


The CONVERT LOG command requires: 

• The CMKRNL privilege 

• Read access to the existing transaction log and the directory it is in 

. Read and write access to the directory in which the new transaction log is to 
be created 


CONVERT LOG old-filespec new-filespec 


old-filespec , , , 

The file specification of the transaction log whose records are to be copi . 

The CONVERT LOG command uses the following defaults: 

• If you omit the disk and directory, the CONVERT LOG the 

transaction log in the directories pointed to by the logical SYS$JOURN , 
which must be defined in executive mode in the system logical name table. 

. If vou omit the file type, the CONVERT LOG command uses ,LM$JOURNAL. 


new-filespec 

The file specification of the new transaction log to be created. 

For DECdtm services to use the transaction log, the file must have a name of the 
form SYSTEM$node.LM$JOURNAL, where node is the name of the node. 

The CONVERT LOG command uses the following defaults: 

. If you omit the disk and directory, the CONVERT LOG command creates the 
new transaction log in the first accessible directory pointed to by the logical 
SYS$JOURNAL, which must be defined in executive mode in the system 
logical name table. 

. If you omit the file type, the CONVERT LOG command uses ,LM$JOURNAL. 


/OWNER=uic 

Specifies the owner of the new transaction log. 

Specify the owner using the standard UIC format, as described in the OpenVMS 
User’s Manual. 

/SIZE=size 

Specifies the size of the new transaction log in blocks. 

The minimum size is 100 blocks. If you omit this qualifier, the new transaction 
log is created with the default size of 4000 blocks. 
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CREATE LOG 


Example 


LMCP> CONVERT LOG/SIZE=6000 DISK$L0G2:[LOGFILES]SYSTEMSRED LMSOLD - 
_LMCP> DISK$L0G2:[LOGFILES]SYSTEM$RED.LM$JOURNAL ' 

This example creates a 6000-block transaction log called 
SYSTEM$RED.LM$JOURNAL in directory DISK$LOG2:[LOGFILES]. It then 
copies records from the existing transaction log, SYSTEM$RED LM$OLD in 
directory DISK$LOG2:[LOGFILES], into the new transaction log. 


CREATE LOG 


Creates a new transaction log. 

-Caution__ 

If a node already has a transaction log, using the CREATE LOG command 
to create a new one can corrupt data. 


Requires read and write access to the directory in which the transaction log is to 
oe created. 


Format 


Parameter 


CREATE LOG filespec 


filespec 

The file specification of the transaction log to be created. 

f° r the transaction l °g> the file must have a name of the 

form SYSTEM$node.LM$JOURNAL, where node is the name of the node. 

The CREATE LOG command uses the following defaults: 

• If you omit the disk and directory, the CREATE LOG command creates 

qvqJ^t l0g , in , the firSt accessible directory pointed to by the logical 

JOURNAL, which must be defined in executive mode in the system 
logical name table. 

• If you omit the file type, the CREATE LOG command uses .LM$JOURNAL. 

If you specify a disk and directory not pointed to by SYS$JOURNAL, a warning 
message is displayed. However, the transaction log is still created, but will not be 
used until either (a) SYS$JOURNAL is modified to point to the disk and directory 
w ere the log was created, or (b) you move the new transaction log to a directory 
pointed to by SYS$JOURNAL. y 


Qualifiers 


/NEW_VERSION 

Forces the CREATE LOG command to create a new version of an existing 
transaction log. 
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DUMP 


Example 


DUMP 

Format 

Parameter 

Qualifiers 


__ Caution- 

Creating a new version of an existing transaction log can lead to data 
corruption. 

The data in the two transaction logs cannot be merged. Once it has 
started using the new transaction log, DECdtm services cannot access any 
transaction records in the old transaction log. 


/OWNER=uic 

Specifies the owner of the transaction log. 

Specify the owner using the standard UIC format, as described in the OpenVMS 
User’s Manual. 

/SIZE=size 

Specifies the size of the transaction log in blocks. 

The minimum size is 100 blocks. If you omit this qualifier, the transaction log is 
created with the default size of 4000 blocks. 


LMCP> CREATE LOG/SIZE=5000 DISK$L0G1:[LOGFILES]SYSTEM$0RANGE.LM$JOURNAL 

This example creates a 5000-block transaction log for node ORANGE in 
DISK$LOGl:[LOGFILES]. 


Displays the contents of a transaction log. 

Requires read access to the transaction log and the directory it is in. 


DUMP filespec 


The file specification of the transaction log whose contents you want to display. 
The DUMP command uses the following defaults: 

. If you omit the disk and directory, the DUMP command looks for the 

transaction log in the directories pointed to by the logical SYS$JOURNAL, 
which must be defined in executive mode in the system logical name table. 

• If you omit the file type, the DUMP command uses ,LM$JOURNAL. 


/ACTIVE 

Selects records only for transactions 


that have not yet been forgotten. 


14-8 









LMCP 

DUMP 


/FORMAT(default) 

/NOFORMAT 


Determines whether the contents of the transaction log are displayed as 
formatted records. Specify both the /NOFORMAT and the /HEX qualifiers to 
display the contents of the transaction log in hexadecimal only. 


If the /NOFORMAT qualifier is specified without the /HEX 
transaction log header is displayed. 


qualifier, only the 


/HEX 

/NOHEX(default) 

Specifies that the contents of the transaction log are displayed as both ASCII 
characters and hexadecimal longwords. Specify both the /NOFORMAT and /HEX 
qualifiers to display the contents of the transaction log in hexadecimal only. 

/LOGID=logid 

Selects records only for transactions that have participants whose logid field 
matches the specified value. 


The logid is in the Log ID field, to the right of the Type field. The value 
specify must be exactly as it appears in the display, including hyphens. 

Note that you can use this qualifier only with the /RM qualifier. 


you 


/OUTPUT[=filespec] 

Requires read and write access to the directory in which the output file is to be 


Specifies where the output from the DUMP command is sent. If you omit this 
qualifier output is sent to the current SYS$OUTPUT device (usually your 
terminal). To send the output to a file, use the /OUTPUT qualifier. If you do not 

supply a file specification, the output is sent to the file LMCP DUMP LIS in vour 
default directory. “ J 


/RM=name 

Selects records only for transactions that have participants whose names begin 
with the specified value. 


The participant name is shown in the Name field, and is output in both ASCII 
and hexadecimal. 

If the participant name includes undisplayable characters, you can select records 
for that participant by using the hexadecimal form of its name. When specifying 
the hexadecimal form of the name, you must convert it by reversing the pairs in 
the hexadecimal number. For example, if the participant name is: 

Name (11): "SYSTEM$RED" (4445 52244D45 54535953) 

the value you specify for the /RM qualifier is: 

/RM=%X53595354454D24524544 

/STATE=COMMITTED 

/STATE=PREPARED 

Selects records only for transactions in either the Committed or Prepared states. 

/TID=transaction_id 

Selects records only for the specified transaction. 
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DUMP 


The transactionjd is shown in the Transaction ID field. The value you specify 
must be exactly as it appears in the display, including hyphens. 

Description 

Use the DUMP command to display the contents of a transaction log. 

Example 14-1 is a sample of a transaction log, with the important fields 

identified. 


Example 14-1 Sample Transaction Log 


Log Manager Control Program VI.1 

Dump of transaction log DISK$LOGFILE:SYSTEM$BLUE.LM$JOURNAL;1 
End of file block 4002 / Allocated 4002 

Transaction log UID: 647327AO-2674-11C9-8001-AA00040069F8 O 

Penultimate Checkpoint: 000000000239 0039 
Last Checkpoint: 00000000042E 002E 


Dump of transaction 
Present Length: 

VBN Offset: 

Section: 


Log DISK$LOGFILE:SYSTEM$BLUE.LM$JOURNAL;1 
L34 (00000086) Last Length: 0 (00000000) 

0 (00000000) Virtual Block: 2 (00000002) 

1 1(10000003) 


© 


Record number 1 (00000001) ,© 114 (0072) bytes O 

Transaction 10^10017140-2676-1109^34-080026174360 © (8-JUL-1995 14:08:29.14) 
DECdtm Services Log Format VI.1 O 


Type ( 2) 
Name (13) 
Type ( 8) 
Name (6): 
Type ( 3) 
Name (6): 


CHILD 1 ©* FOmat Vi L -D: F1469720-4AOC-11CC-8001-AA000400B7A5 © 

"SYSTEMSWESTRN" (4E 52545345 57244D45 54535953) © 

CHILD NODE ©^ Log ID: F1469720-4AOC-11CC-8001-AA000400B7A5 © 
LOCAlW© 52 54534 Log ) I^ > 037100C0-0019-0003-0100-000000000000 © 

"ORANGE" (4547 4E41524F) © 


In this example, the significant fields are: 

O Transaction log header - information about the transaction log’s attributes. 

© Section header — the section header of multiple transaction records. 

© Record number — the record number, in both decimal and hexadecimal. 

© Record size — the record size in both decimal and hexadecimal. 

© Transaction state — the type of the record. This can be: 

• Prepared 

This type of record is logged when the transaction enters the Prepared 
state. Note that this type of record is not logged at the node on which the 
transaction was started. 

• Committed 

This type of record is logged when the transaction enters the Committed 
state. 
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DUMP 


• Forgotten 

This type of record is logged: 

— When the transaction is aborted, if a record of type Prepared was 
logged for the transaction. 

- For a transaction that commits, when no participants require the local 
DECdtm transaction manager to remember that the outcome of the 
transaction is commit. 

Note that DECdtm uses the presumed abort logging protocol. 

• Checkpoint 

Unlike the other types of record, this is not associated with a particular 
transaction. It is used internally by the DECdtm transaction manager to 
compress space in the transaction log. 

© Transaction ID — the unique transaction identifier (TID) generated by the 
DECdtm transaction manager. 

© DECdtm Services Log Format — the version number of the transaction log 
format. 

© lype — information about the participant in the transaction. This can be: 

Child an immediate child transaction manager. This transaction 
manager may query the local DECdtm transaction manager to determine 
the outcome of the transaction. 

Child Node the name of the node that an immediate child transaction 
manager is on. 

Parent — the immediate parent transaction manager. The local DECdtm 
transaction manager may query this transaction manager to determine 
the outcome of the transaction. 

• Parent Node the name of the node that an immediate parent 
transaction manager is on. 

• Local RM — a resource manager on the local node. 

© Log ID — the identifier of the participant’s log. For type Child, Child Node 
Parent, or Parent Node, this is the identifier of the DECdtm transaction log. 
For a local resource manager, this is the identifier of its private log. 

© Name — The name of the participant in the transaction, in both ASCII and 
hexadecimal. 


Example 


LMCP> DUMP/RM="RMS$” DISK$LOGFILE:SYSTEM$BLUE.LM$JOURNAL 

This example displays the contents of the transaction log for node BLUE, 
selecting only transactions in which RMS Journaling for OpenVMS is 
participating. 
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HELP 


Dump of transaction log DISK$LOGFILE:SYSTEM$BLUE.LM$JOURNAL,1 
End of file block 4002 / Allocated 4002 

Transaction log UID: 6A034B20-6FCC-0095-D7E4-EAA500000000 

Penultimate Checkpoint: 00000000382E 002E 
Last Checkpoint: 000000003C2E 002E 


Dump of transaction log DISK$LOGFILE:SYSTEM$BLUE.LM$JOURNAL;1 
Present Length: 46 (0000002E) Last Length: 512 J0000200 

VBN Offset: 30 (0000001E) Virtual Block: 32 (00000020) 

Section: 1 (00000001) 


Record number 2 (00000002), 5 (0005) bytes 

Transaction state (3): CHECKPOINT 

Checkpoint record contains no active transactions. 


Record number 1 (00000001), 21 (0015) bytes 
Transaction state (0): FORGOTTEN 

Transaction ID: 271D9FCO-7082-0095-98E7-EAA500000000 


Dump of transaction log DISK$LOGFILE:SYSTEM$BLUE.LM$JOURNAL;1 
Present Length: 113 (00000071) Last Length: 512 00000200 

VBN Offset: 29 (0000001D) Virtual Block: 31 (0000001F) 

Section: 2 (00000002) 

Record number 1 (00000001), 93 (005D) bytes 
Transaction state (2): COMMITTED 

Transaction ID: 271D9FCO-7082-0095-98E7-EAA500000000 ( 3-MAR-1995 13:53: 
DECdtm Services Log Format VI.1 

Type ( 2): CHILD Log ID: EF006060-CF37-11C9-8001-AA000400DEFA 

Name (10): "SYSTEM$ORANGE" (45 474E4152 4F244D45 54535953) 

Type ( 8): CHILD NODE Log ID: EF006060-CF37-11C9-8001-AA000400DEFA 
Name ( 6): "ORANGE" (4547 4E41524F) 

LOCAL RM Log ID: 28C5D180-7082-0095-0000-000000000000 

"RMS$USER1. 


Type ( 3) 
Name (22) 


\ 66 ) . .. 

(0000 00178B60 00000000 00000031 52455355 24534D52) 


Total of 1 transactions active, 0 prepared and 1 committed 


HELP 


Gives help on LMCP commands. 

Format 

HELP [help-topic [help-subtopic]] 

Parameter 

help-topic 

Specifies the command that you want help for. 

help-subtopic 

Specifies the parameter or qualifier that you want help for. 


03.42) 
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REPAIR 


REPAIR 

Changes the state of transactions. 

-Caution_ 

The REPAIR command can corrupt data. Use it only if none of the 
resource managers participating in the transaction provides a means of 
changing transaction states. 


The REPAIR command requires: 

• The CMKRNL privilege 

• Read and write access to the transaction log and the directory it is in 

Format 

REPAIR filespec 

Parameter 

filespec 

The file specification of the transaction log containing the transactions whose 
states you want to change. 

The REPAIR command requires the following: 

• The logical SYS$JOURNAL must be defined in executive mode in the system 
logical name table. 

• The transaction log must be in a directory pointed to by the logical 
SYS$JOURNAL. 

• The file type of the transaction log must be ,LM$JOURNAL. 

The REPAIR command uses the following defaults: 

• If you omit the disk and directory, the REPAIR command looks for the 
transaction log in the directories pointed to by the logical SYS$JOURNAL. 

• If you omit the file type, the REPAIR command uses ,LM$JOURNAL. 

Qualifiers 

/LOGID=logid 

Selects records only for transactions that have participants whose logid field 
matches the specified value. 

The logid is in the Log ID field, to the right of the Type field in the output from 
the DUMP command. The value you specify must be exactly as it appears in the 
display, including hyphens. 

Note that you can use this qualifier only with the /RM qualifier. 

/RM=name 

Selects records only for transactions that have participants whose names begin 
with the specified value. 
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REPAIR 


The participant name is shown in the Name field in the output from DUMP, and 
is output in both ASCII and hexadecimal. 

If the participant name includes undisplayable characters, you can select records 
for that participant by using the hexadecimal form of its name. When specifying 
the hexadecimal form of the name, you must convert it by reversing the pairs in 
the hexadecimal number. For example, if the participant name is: 

Name (11): "SYSTEM$RED" (4445 52244D45 54535953) 

the value you specify for the /RM qualifier is: 

/RM=%X53595354454D24524544 

/STATE=COMMITTED 

/STATE=PREPARED 

Selects records only for transactions in either the Committed or Prepared states. 

/TID=transaction_id 

Selects records only for the specified transaction. 

The transaction_id is shown in the Transaction ID field in the output from the 
DUMP command. The value you specify must be exactly as it appears in the 
display, including hyphens. 

Description 

Use the REPAIR command to change the state of transactions. 

__ Caution- 

The REPAIR command can corrupt data. Use it only if none of the 
resource managers participating in the transaction provides a means of 
changing transaction states. 


Use this command only if none of the resource managers participating in the 
transaction provides a means of changing the transaction state. For example, if 
Rdb for OpenVMS is a participant in the transaction, do not use REPAIR; use the 
Rdb for OpenVMS Management Utility (RMU) commands instead. Similarly, if 
DBMS for OpenVMS is a participant, use the Database Operator utility (DBO) 
commands. 

Change the transaction state only when you already know the outcome of the 
transaction and need to manually update the transaction log immediately. You 
might want to do this because, for example, you have lost the network link to a 
remote node. 

When you use the REPAIR command you use qualifiers to specify which 
transactions you want to change. By default, the REPAIR command selects 
all transactions. 

Once you have selected the transactions to change, you enter the REPAIR 
subcommand mode. Within this mode, the prompt changes to REPAIR> and you 
have an additional set of subcommands. You use these subcommands either to 
manually change the state of the transaction or to select the next transaction that 
matches your selection criteria. The subcommands are as follows. 
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REPAIR 


Subcommand 

Action 

ABORT 

Specifies that a Prepared transaction is to be aborted by 

removing its record from the transaction log. This writes a 
record of type Forgotten for the transaction. 

Note that DECdtm services use the presumed abort logging 
protocol. 

COMMIT 

Specifies that a Prepared transaction is to be committed. 

This writes a record of type Committed for the transaction. 

EXIT 

Returns to the LMCP> prompt. 

FORGET 

Specifies that a Committed transaction can be removed from 
the transaction log. This writes a record of type Forgotten 
for the transaction. 

NEXT 

Displays the next transaction that matches your selection 
criteria. 


LMCP displays each of the selected transactions in turn, so that you can change 
them. For each selected transaction, you can either use the ABORT, COMMIT 
and FORGET subcommands to change the state of the transaction, or use the’ 
NEXT subcommand to select the next transaction. 

To exit from the REPAIR subcommand mode, enter the EXIT subcommand or 
press Ctrl/Z. 

Example 

LMCP> REPAIR/STATE=PREPARED DISK$JOURNALS:[LOGFILES]SYSTEM$ORANGE 

In this example, transactions to be modified are selected from the transaction log 
for node ORANGE. The transactions selected are those in the Prepared state. 

The first transaction is committed by manually changing its state from Prepared 
to Committed, then the NEXT subcommand is used to advance to the next 
selected transaction. 


Dump of transaction log DISK$JOURNALS:[LOGFILES]SYSTEM$ORANGE•1 
End of file block 4002 / Allocated 4002 
Log Version 1.0 


Transaction log UID: 98A43B80-81B7-11CC-A27A-08002B1744C3 
Penultimate Checkpoint: 00000407B9AC 07AC 
Last Checkpoint: 00000407C3B7 07B7 


Transaction state (1): PREPARED 

Transaction ID: 9F7DF804-CBC4-11CC-863D-08002B17450A (18-OCT-1995 16-11-03 67) 
DECdtm Services Log Format VI.1 


Type ( 3) 
Name (1): 
Type ( 4) 
Name (13) 
Type (16) 
Name (6): 


LOCAL RM 
"B" (42) 

PARENT 

"SYSTEM$BLUE" 
PARENT NODE 
"BLUE" (45554C42)) 


Log ID: 00000000-0000-0000-0000-000000000000 

Log ID: AEC2FB64-C617-11CC-B458-08002B17450A 
(45554C 42244D45 54535953) 

Log ID: AEC2FB64-C617-11CC-B458-08002B17450A 


REPAIR>COMMIT 

REPAIR>NEXT 
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SHOW LOG 

Format 

Parameter 

Qualifiers 


Displays information about transaction logs. 

Requires read access to the transaction logs and the directories they are in 
SHOW LOG [filespec] 


The file specification of the transaction logs you want to display information 
about. This can include the percent (%) and asterisk (*) wildcard characters. 

The SHOW LOG command uses the following defaults: 

• If you omit the disk and directory, the SHOW LOG command looks for the 
transaction log in the directories pointed to by SYS$JOURNAL, which must 
be defined in executive mode in the system logical name table. 

• If you omit the file type, the SHOW LOG command uses ,LM$JOURNAL. 


Displays information about the local node’s transaction log. This includes the 
number of checkpoints and stalls that have occurred since DECdtm services 
started on this node. 

To use the /CURRENT qualifier: 

• You must have the CMKRNL privilege. 

• You must omit the parameter to the SHOW LOG command. 


Lists all attributes of the transaction logs. For each transaction log, both the full 
file specification of the transaction log and its size are displayed. 

If you do not specify which transaction log you want to display, the SHOW LOG 
command lists all transaction logs of the form SYSTEM$*.LM$JOURNAL, in all 
directories pointed to by the logical SYS$JOURNAL, which must be defined in 
executive mode in the system logical name table. 

/OUTPUT[=filespec] . 

Requires read and write access to the directory in which the output hie is to be 

created. 

Specifies where the output of the SHOW LOG command is sent. If you omit 
this qualifier, output is sent to the current SYS$OUTPUT device (usually your 
terminal). To send the output to a file, use the /OUTPUT qualifier. If you do not 
supply a file specification, the output is sent to the file LMCP_SHOW.LIS in your 
default directory. 
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Example 


LMCP> SHOW LOG/FULL 

This example displays full details about the transaction logs in all directories 
pointed to by the logical SYS$JOURNAL. This logical is defined in executive 
mode in the system logical name table. 

Directory of DISK$JOURNALS:[LOGFILES] 

DISK$JOURNALS:[LOGFILES]SYSTEM$BLUE.LM$JOURNAL;1 
End of file block 4002 / Allocated 4002 
Log Version 1.0 

Transaction log UID: 647327A0-2674-11C9-8001-AA00040069F8 
Penultimate Checkpoint: 000000001A39 0039 
Last Checkpoint: 000000001C8A 008A 

Total of 1 file. 

Directory of DISK$RED:[LOGFILES] 

DISK$RED:[LOGFILES]SYSTEM$RED.LM$JOURNAL;1 
End of file block 4002 / Allocated 4002 
Log Version 1.0 

Transaction log UID: 17BB9140-2674-11C9-8001-AA0004006AF8 
Penultimate Checkpoint: 000000ECADE5 41E5 
Last Checkpoint: 000000F1O5FC 41FC 

Total of 1 file. 

Directory of DISK$LOGFILES:[LOGS] 

DISK$LOGFILES:[LOGS]SYSTEM$YELLOW.LM$JOURNAL;1 
End of file block 1002 / Allocated 1002 
Log Version 1.0 

Transaction log UID: 590DAA40-2640-11C9-B77A-08002B14179F 
Penultimate Checkpoint: 00000C8B4819 2019 
Last Checkpoint: 00000C8BC15B 335B 

Total of 1 file. 

Total of 3 files in 3 directories. 
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ACL Editor Keypad Editing Commands 


By default, the access control list editor (ACL editor) prompts you for each access 
control entry (ACE) and provides values for some of the fields within an ACE. 

^ can navi S ate the ACE fields by using keypad commands, such as FIELD and 
ITEM. 

This appendix describes all the keypad editing commands supplied by the 
ACL editor. You can supplement or change these key definitions by modifying 
and recompiling the ACL editor section file SYS$LIBRARY:ACLEDIT.TPU 
(see Appendix B for more information). To get help on the ACL editor keypad 
commands, press PF2. 

A.1 ACL Editor Keypad Commands 

Figure A-lshows the default ACL editor keypad commands for LK201 keyboards. 
The numeric keypad on VTlOO-series terminals is identical to that of the LK201 
keyboard shown in Figure A-l; VT100 terminals, however, do not have the 
supplemental editing keypad (keys El through E6). 
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A.1 ACL Editor Keypad Commands 

Figure A-1 Keypad for an LK201-Series Keyboard 
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Table A-1 describes each of the keypad commands you can use with the ACL 
editor. In this table, KPn refers to a keypad key labeled with the number n. For 
example, KP4 refers to the keypad key labeled with the number 4. 


Table A-1 ACL Editor Keypad Commands 


Command 

Key or 

Key Sequence 

Description 

ADVANCE 

KP4 

Sets the current direction forward for the FIND, FNDNXT, 

MOVE SCREEN, OVER ACE, and WORD commands. 
Movement is toward the end of the ACL. 

ADV FIELD 

GOLD-KP7 

Completes the current ACE field and moves the cursor to 
the next ACE field. 

BACKUP 

KP5 

Reverses the current direction for the FIND, FNDNXT, 
MOVE SCREEN, OVER ACE, and WORD keys. Movement 
is toward the beginning of the ACL. 

BOTTOM 

GOLD-KP4 

Positions the cursor after the last line of the last ACE. Any 
entries you add are placed at the end of the ACL. 

DEL ACE 

PF4 

Deletes the entire ACE in which the cursor is positioned 
and stores it in the delete-ACE buffer. 

DEL C 

Comma 

Deletes the character on which the cursor is positioned and 
stores it in the delete-character buffer. 

DEL EOL 

GOLD-KP2 

Deletes text from the current cursor position to the end of 
the line and stores it in the delete-line buffer. 



(continued on next page) 
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ACL Editor Keypad Editing Commands 
A.1 ACL Editor Keypad Commands 


Table A 1 (Cont.) ACL Editor Keypad Commands 


Command 

Key or 

Key Sequence 

Description 

DEL W 

Minus 

Deletes the text from the current cursor position to the 
beginning of the next word and stores it in the delete-word 
buffer. 

ENTER 

Enter 

Indicates that the current ACE is complete. The ACL 
editor terminates the insertion and verifies that the syntax 
of the ACE is complete. You can press the Enter key 
while the cursor is located at any position within the ACE. 
(Pressing the Return key produces the same results.) 

EOL 

KP2 

Moves the cursor to the end of the current line. 

FIELD 

KP7 

Completes the current ACE field and moves the cursor to 
the next ACE field or subfield, inserting text as needed. 

If the ACL editor is not in prompt mode, the ACL editor 
advances to the next field in the current ACE. 

FIND 

GOLD-PF3 

Searches for an occurrence of a string. Press the FIND key 
and then enter the string from the main keyboard. Press 
the ENTER key to search for the string in the current 
direction, or the ADVANCE or BACKUP key to change the 
search direction. 

FNDNXT 

PF3 

Searches in the current direction for the next occurrence of 
the string previously entered with the FIND key. 

GOLD 

PF1 

When pressed before another keypad key, specifies the 
second keys alternate function (the bottom function on the 
keypad diagram). 

HELP 

PF2 

Displays information about using the editing keypad. 

HELP FMT 

GOLD-PF2 

Displays information about ACE formats. 

INSERT 

GOLD-KPO 

Moves all text from the current line down one line, leaving 
a blank line where an ACE is to be inserted. 

ITEM 

Period 

Selects the next item for the current ACE field. If the ACL 
editor is not in prompt mode, this key is ignored. 

MOVE SCREEN 

KP8 

Moves the cursor one screen in the current direction (see 
ADVANCE or BACKUP). A screen is defined as two-thirds 
the number of lines in the display. 

OVER ACE 

KPO 

Moves the cursor to the beginning of the next ACE (if the 
direction is set to ADVANCE) or to the beginning of the 
previous ACE (if the direction is set to BACKUP). 

TOP 

GOLD-KP5 

Moves the cursor position to the first character of the first 
ACE in the access control list. 

UNDACE 

GOLD-PF4 

Inserts the contents of the delete-ACE buffer in front of 
the ACE in which the cursor is currently positioned. 

UND C 

GOLD-Comma 

Inserts the contents of the delete-character buffer directly 
in front of the cursor. 

UND W 

GOLD-Hyphen 

Inserts the contents of the delete-word buffer directly in 
front of the cursor. 

WORD 

KP1 

Moves the cursor one word forward (if the direction is 
set to ADVANCE) or backward (if the direction is set to 
BACKUP). 
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A.2 Additional ACL Editing Keys and Key Sequences 


A.2 Additional ACL Editing Keys and Key Sequences 

In addition to keypad editing, the ACL editor lets you use other keyboard keys 
and key sequences to perform editing functions. Table A-2 describes these 
additional ACL editing keys and key sequences. Keys in parentheses indicate the 
equivalent key for an LK201-series keyboard. 


Table A-2 Additional ACL Editing Keys and Key Sequences 


Key or Sequence 

1 


Action Taken When Key or Sequence Is Pressed 


Moves the cursor to the character directly in line below it. If the ACE in which t 

cursor is positioned is new, the ACL editor processes the ACE before moving the 
cursor If the entry is incomplete or formatted incorrectly, an error occurs and the 


t 


GOLD-<- 
GOLD—> 


cursor does not move. 

Moves the cursor one character to the left. If the cursor is at the left margin, moves 
it to the rightmost character in the line above. 

Moves the cursor one character to the right. If the cursor is at the right margin, 
moves it to the leftmost character in the line below. 


Moves the cursor to the character directly in line above it. If the ACE in which the 
cursor is positioned is new, the ACL editor processes the ACE before moving the 
cursor. If the entry is incomplete or formatted incorrectly, an error occurs and the 
cursor does not move. 


Shifts the text in the display window 8 characters to the left. 
Shifts the text in the display window 8 characters to the right. 


Backspace (F12) 
Ctrl/A 

Ctrl/D 

Ctrl/H 

Ctrl/J 

Ctrl/R 

GOLD-Ctrl/R 


Moves the cursor to the beginning of the current line. 

Changes the current mode from insert mode to overstrike mode or from oyerstrike 
mode to insert mode. Insert mode (the default) inserts a character to the left ot the 
current character. Overstrike mode replaces the current character. 

Allows you to execute one TPU command. 

Moves the cursor to the beginning of the line. (Performs the same function as the 
backspace key.) 

Deletes the text from the cursor back to the beginning of the word. (Performs the 
same function as the linefeed key.) 

Refreshes the screen display. Clears and redraws the screen, deleting any extraneous 
characters or messages that might have appeared on the screen but are not part ol 
the ACL you are editing. (Performs the same function as Ctrl/W.) 

Returns the ACL to its original state before the ACL editor was invoked. (Performs 
the same function as GOLD-Ctrl/W.) 


Ctrl/U Deletes the text from the cursor to the beginning of the line. 

GOLD-Ctrl/U Inserts the contents of the deleted-line buffer into the line at the current position. 

The line might wrap automatically. 


Ctrl/W 

GOLD-Ctrl/W 

Ctrl/Z 

GOLD-Ctrl/Z 
Delete (O) 


See Ctrl/R. 

See GOLD Ctrl/R. 

Ends the editing session and updates the ACL. (Unless otherwise specified, any 
recovery and journal files are deleted.) 

Ends (quits) the editing session without saving any of the changes made to the ACL. 
(Unless otherwise specified, any recovery and journal files are deleted.) 

Deletes the character to the left of the cursor. 

(continued on next page) 
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A.2 Additional ACL Editing Keys and Key Sequences 


Table A-2 (Cont.) Additional ACL Editing Keys and Key Sequ ences 

Key or Sequence Action Taken When Key or Sequence Is Pressed 


Linefeed (F13) 


Tab 


Deletes the text from the cursor back to the beginning of the word. If the cursor is 
positioned at the first character of the word, deletes to the beginning of the previous 

Moves the text located to the right of the cursor to the next tab stop. 

A.3 ACL Editing Keys on the Supplemental Keypad (LK201-Series 
Keyboards) 

You can use the supplemental keypad on an LK201-series keyboard to move 
sections of text from one part of an ACL to another. However, note that certain 
supplemental editing keys (Insert Here, Remove, and Select) require a PASTE 
buffer, which is not enabled by default. To enable the PASTE buffer for the 
current editing session, do the following: 

1. Press Ctrl/D 

2. At the TPU command: prompt, enter the following statement: 

TPU command: ACLEDIT$X_PASTE_BUFFER:=1 

3. Press Ctrl/D again, and enter the following statement: 

TPU command: ACLEDIT$X_CHECK_MODIFY:=0 

Setting the value of the ACLEDIT$X_CHECK_MODIFY variable to 0 
prevents the ACL editor from checking for a modifiable ACE. The two 
features (support for the PASTE buffer and the check for a modifiable ACE) 
are not compatible. 

To enable the PASTE buffer for all ACL editing sessions, change the values of the 
variables ACLEDIT$X_PASTE_BUFFER and ACLEDIT$X_CHECK_MODIFY in 
the ACL editor section file and recompile the file (see Appendix B). 

Table A-3 describes the supplemental keypad keys you can use with the ACL 
editor. 


Table A-3 ACL Editing Keys on the Supplemental Keypad 


Key or 

Key Sequence 


Find 


Insert Here 


Remove 


Description 


Elicits the Search for: prompt as the first step in the FIND 

operation. Type the search string after the prompt; then, press 
either the Do key or the Enter key to process the search. Performs 
the same function as the FIND keypad command. 

Indicates where an ACE is to be inserted or, if support for the 
PASTE buffer is enabled, indicates the line where the selected text 
m the PASTE buffer is to be inserted. 

Removes the selected text to the PASTE buffer. Each time you press 

key ’ the ACL editor deletes the previous contents of the 
-rAol-E buffer. 

(continued on next page) 


A-5 












A^M^Edlwn^Ke^on^h^Si^Uemontal Keypad (LK201-Ser,es Keyboards) 


Table A-3 (Cont.) ACL Editing Keys on the Supplemental Keypad 


Key or 

Key Sequence 

GOLD-Remove 

(COPY) 

Select 

Prev Screen 
Next Screen 


Description ___ _ 

Copies the selected text to the PASTE buffer. Each time you use the 
COPY command, the ACL editor deletes the previous contents ot 
the PASTE buffer. 

Marks the beginning of a range of text to be removed or copied to 
the PASTE buffer. Press the Select key. Then, move the cursor to 
include the desired amount of text to be removed or copied. Press 
either Remove or GOLD-Remove (COPY) to complete the operation. 

Moves the cursor to the previous screen. By default, a screen is 
defined as two-thirds the number of lines in the display. 

Moves the cursor one screen forward. By default, a screen is defined 
as two-thirds the number of lines in the display. 


A-6 








_B 

Customizing the ACL Editor 


You can modify the access control list editor (ACL editor) by modifying 
and recompiling the ACL section file SYS$LIBRARY:ACLEDIT.TPU 
(the source file used to create the compiled ACL section file 

SYS$LIBRARY:ACLEDT$SECTION.TPU$SECTION). You can also create 

your own ACL section file. 


See the DEC Text Processing Utility Reference Manual for more information on 
writing and processing section files. 

B.1 Modifying Variables in the ACL Section File 

Table B-l lists the ACL section file variables and their defaults. 


Table B-1 ACL Section File Variables 

Variable 

ACLEDIT$X CHECK DUPLICATES 


ACLEDIT$X_CHECK_MODIFY 


ACLEDIT$X_DIRECTORY_FILE 


Meaning 

Controls whether a check for duplicate ACEs 
is made. This variable can take the following 
values: 

0 No duplicate ACE check is made. 

1 A duplicate ACE check is made. If the 
ACE to be entered matches an existing 
ACE, an error message is returned. 

This is the default. 

Allows or disallows modification of ACEs. 
This variable can take the following values: 

0 The ACE can be modified. 

1 The ACE cannot be modified. If an 
attempt is made to modify the ACE, it 
is replaced with the original ACE. This 
is the default. 

Indicates whether the object is a directory 
file. This variable can take the following 
values: 

0 The object is not a directory file. 

1 The object is a directory file. 

(continued on next page) 
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Customizing the ACL Editor 

B.1 Modifying Variables in the ACL Section File 

Tahie B-1 (Cont.l ACL Section File Variables 

Variable 

Meaning 

ACLEDIT$X_PASTE_BUFFER 

Controls whether PASTE buffer support is 
enabled for VT200 series terminals. This 
variable can take the following values: 


0 PASTE buffer support is disabled. This 
is the default. 


1 PASTE buffer support is enabled. 

ACLEDIT$X_PROMPT 

Controls whether automatic text insertion 
(prompt mode) is enabled. This variable can 
take the following values: 


0 Prompt mode is disabled. 


1 Prompt mode is enabled. This is the 
default. 

ACLEDIT$X_USE_DEFAULT_OPT 

Controls whether the DEFAULT option 
can be used with nondirectory ACEs. This 
variable can take the following values: 


0 The DEFAULT option can only be used 
with ACEs of directory (.DIR) files. This 
is the default. 


1 The DEFAULT option is available for 
use with ACEs of all object types. 

ACLEDIT$C_WINDOW_SHIFT 

Specifies the number of columns to shift the 
edit window in the direction wanted, GOLD 
key and left arrow for a left shift and GOLD 
key and right arrow for a right shift. The 
default is 8 columns. 


If you modify any of the variables in Table B-l or change any other part of the 
ACL section file, recompile the section file with the following command: 

$ EDIT/TPU/NOSECTION/COMMAND=SYS$LIBRARY:ACLEDIT 

Use the preceding command if you make changes directly to the source code 
file (SYS$LIBRARY:ACLEDIT) that creates the compiled ACL section file 
SYS$LIBRARY:ACLEDT$SECTION. If you add a private command file to the 
existing ACL section file, recompile the section file using the following command: 

$ EDIT/TPU/SECTION=SYS$LIBRARY: ACLEDT$SECTION/COMMAND=CUSTOM_ACL. TPU 

The compiled DECtpu ACL section file is placed in your current directory. To use 
the new section file, do one of the following: 

. Move the compiled section file, ACLEDT$SECTION.TPU$SECTION, to the 
SYS$LIBRARY directory. This changes the default ACL editor section file for 

all users. 

• Keep the compiled section file in your directory and define the logical name 
ACLEDT$SECTION in your LOGIN.COM file to point to the file, as follows: 

$ DEFINE ACLEDT$SECTION yourdisk: [yourdir]ACLEDT$SECTION 

Note that the default file type for the section file before compiling (the source file) 
is TPU, and the default file type for the compiled section file is TPU$bEC 1 iOJN. 

For more information on writing and processing a DECtpu section file, see the 
DEC Text Processing Utility Reference Manual. 
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B.2 Using the ACL Editor CALLJJSER Routine 


J!lL ACL e< ^ or CALL_USER routine is part of the shareable image 

You can i ncor P orate the ACL editor CALL_ 
USER routine with its existing function codes into your own ACL section file or 

you can write your own CALLJJSER routine that recognizes a different set of 
function codes. 


Yhe edltor CALL_USER routine recognizes only those functions used by 
the ACL editor DECtpu section file. All other function codes are passed to a 
user-supplied CALLJJSER routine; if the high-order word of the CALLJJSER 
function code contains the ACL editor facility code (277 in decimal or 115 in 
hexadecimal), it is handled by the ACL editor CALLJJSER routine. Otherwise, 
an attempt is made to locate a user-supplied CALLJJSER routine. Refer to 
the description of the CALLJJSER routine in the DEC Text Processing Utility 
Reference Manual for more information on creating your own CALL USER 
routine. 


Table B 2 describes the CALL_USER routine function codes supported by the 
ACL editor. 


Table B-2 CALL_USER Function Codes 

Function 

Code _Mnemonic Description 


18153473 ACLEDIT$C PARSE ACE 

18153474 ACLEDIT$C_CHECK_MODIFY 

18153475 ACLEDIT$C_PROMPT_MODE 

18153476 ACLEDIT$C_CHECK_ACE 

18153477 ACLEDIT$C_CHECK_DIR 


Parses the input string (ACE) and returns the 
parsed (binary) ACE if no errors are found. 
Otherwise, the returned string contains a zero 
as the first two characters, and the unparsed 
portion of the input ACE as the remainder of the 
string. 

Returns the string “READ_WRITE” if the ACE can 
be modified by the user. Otherwise, returns the 
string “READ_ONLY.” 

Returns the string “PROMPTJMODE” if the 
prompt mode option was specified. Otherwise, 
returns the string “NOPROMPTJVIODE.” 

Parses the input string (ACE) and returns the 
parsed (binary) ACE if no errors are found. 
Otherwise, the ACE text is highlighted in 
reverse video and a DECtpu variable of the form 
ACLEDIT$X_RANGE_x is created to identify the 
ACE in error. (The “x” is a sequential number 
starting with 1.) 

Returns the string “DIRECTORYJ?ILE” if the 
object being edited is a directory file. Otherwise, 
returns the string “NODIRECTORYJTLE.” 

(continued on next page) 
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Customizing the ACL Editor 

B.2 Using the ACL Editor CALLJJSER Routine 

Table B-2 (Cont.) CALLJJSER Function Codes 


Function 

Code 

Mnemonic 

Description 

18153478 

acledit$c_set_candidate 

Parses the input string (ACE) and returns the 
string “PARSE_OK” if no error was encountered. 
Otherwise, returns the string “PARSE J3RROR.” 

If the parse was successful, a check is made for 
duplicate ACEs using the CALLJJSER function 
ACLEDIT$C_CHECK_DUP. 

18153479 

ACLEDIT$C_CHECK_DUP 

Parses the input string (ACE) and returns 
the string “PARSE_ERROR” if an error was 
encountered. Otherwise, the parsed (binary) 

ACE is compared with the candidate ACE set 
by the CALLJJSER function ACLEDIT$C_SET_ 
CANDIDATE. Returns the string “DUPLICATE_ 
ACE” if the ACE is a duplicate, or “UNIQUE_ 
ACE” if it is not a duplicate. 

18153482 

ACLEDIT$C_MESSAGE 

Assumes the input string is a system error code 
and returns in the ACL editor message window 
the message text associated with the error code. 
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Accounting Information for Programmers 


Table C 1 gives a summary of the system services that relate to accounting. No 
system service reads accounting files; to do this you must use knowledge of the 
structure of accounting files. 


Table C-1 Summary of Accounting System Services 


System Service 

Description 

$CREPRC 

$SNDJBC 

Creates a process in which accounting can be disabled. 

Controls what resources are logged in the current accounting file, or 
logs a user-defined record in the current accounting file. 


This appendix describes the structure of an accounting file. It is for programmers 
who want to access accounting data directly. 


-Note__ 

The formats described here are subject to change without notice in a 
future release. 


The symbols and offsets described in this appendix are defined by the $ACRDEF 
macro in the STARLET library. 

C.1 Format of an Accounting File Record 

An accounting record consists of an accounting record header and a number of 
information packets. The number and type of information packets depend on the 
type of the record. 

Figure C—1 illustrates the general format of an accounting record. Table C—2 
describes the fields in the record header. The type field in the record header is 
subdivided into five fields, described in Table C-3. 
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Figure C-1 Format of an Accounting Record 
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Table C-2 Fields in an Accounting Record Header 


Symbolic Offset 

Description 

ACR$W_TYPE 

Identifies the type of the record. This field is subdivided into 

five fields, described in Table C—3. (word) 

ACR$W_LENGTH 
ACR$Q SYSTIME 

Total length of the record, in bytes, (word) 

System time (64-bit absolute time), (quadword) 

Table C-3 ACR$W TYPE Fields in an Accounting Record Header 

Symbolic Offset 

Description 


ACR$V_PACKET Identifies this header as a record header. This bit must be 0. 

(1 bit) 

ACR$V TYPE Identifies the type of the record. The eight record types are 

described in Table C—4. (7 bits) 

ACR$V_SUBTYPE Identifies the type of process with which the record is 

associated. The subtypes (4 bits) are: 


Symbol 

Meaning 

ACR$K_BATCH 

Batch process 

ACR$K_DETACHED 

Detached process 

ACR$K_INTERACTIVE 

Interactive process 

ACR$K_NETW ORK 

Network process 

ACR$K SUBPROCESS 

Subprocess 


(continued on next page) 
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Table C-3 (Cont.) ACR$W_TYPE Fields in an Accounting Reco rd Header 

Symbolic Offset Description 


ACR$V_VERSION 


ACR$V_CUSTOMER 


Note th a t this field is only meaningful for records of type 
ACR$K_IMGDEL and ACR$K_PRCDEL. P 


Identifies the version of the accounting file record structure. 
The versions (3 bits) are: 


Symbol 

Meaning 

ACR$K_VERSION2 

VAX/VMS Version 2.0 

ACR$K_VERSION3T 

VAX/VMS Version 3.0 field test 

ACR$K_VERSION3 

Open VMS Alpha Version 1.0 and 
VAX/VMS Version 3.0 


Identifies whether the record was written by Digital software 
or by customer software. If this bit is 0, the record was written 
by Digital software. If this bit is 1, the record was written by 
customer software. (1 bit) 


C.1.1 Types of Accounting Record 

The type of an accounting record identifies the type of event that caused the 
record to be logged. The eight types of accounting records are shown in Table C-4. 
This table shows the information packets contained in each type of record. 

Table C-4 Types of Accounting Record 

Symbol_ Event Information Packets 


ACR$K FILE BL 

The accounting file was opened 

ACR$K_FILENAME 

ACR$K_FILE_FL 

The accounting file was closed 

ACR$K_FILENAME 

ACR$K_IMGDEL 

An image terminated 

ACR$K_ID 

ACR$K_RESOURCE 

ACR$K_IMAGENAME 

ACR$K_LOGFAIL 

A login attempt failed 

ACR$K ID 
ACR$K_RESOURCE 

ACR$K_PRCDEL 

A process terminated 

ACR$K_ID 

ACR$K_RESOURCE 

ACR$K_PRINT 

A print job finished 

ACR$K ID 
ACR$K_PRINT 

ACR$K_SYSINIT 

The system was initialized 

ACR$K ID 
ACR$K_RESOURCE 

ACR$K_USER 

An accounting message was sent by the 
$SNDJBC system service 

ACR$K ID 

ACR$K USER DATA 


C.1.2 Format of an Information Packet 

The header, in each of the six types of information packets, defines the type of 
packet as follows: 

• File name packet (ACR$K_FILENAME) 

• Identification packet (ACR$K_ID) 
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• Image name packet (ACR$K_IMAGENAME) 

• Print resource packet (ACR$K_PRINT) 

• Resource packet (ACR$K_RESOURCE) 

• User data packet (ACR$K_USER_DATA) 

Section C.1.2.1 describes the general format of an information packet. 

Section C.l.2.2 to Section C.l.2.7 describe the format of each type of information 

packet. 

C.1.2.1 General Format 

Each information packet contains a packet header, followed by data fields, lfie 
data fields can contain fixed-length data, variable-length data, or offsets to 
variable-length data. Offsets contain the distance in bytes from the beginning of 
the packet to the variable-length data. 

All variable-length data are represented as counted strings. Variable-length data 
follow the last fixed-length data field in the packet. Figure C-2 shows the general 
format of an information packet. An information packet may not have values in 
all of its data fields. 

See Section C.l.2.2 to Section C.l.2.7 for complete descriptions of the data fields 
contained in each information packet. 

All information packets start with a packet header that has ACR$W_LENGTH 
and ACR$W_TYPE fields (see Table C-5 and Table C-6). 


Figure C-2 Format of an Information Packet 
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Table C-5 Fields in an Information Packet Header 


Symbolic Offset 

Description 

ACR$W TYPE 

Identifies the type of the packet. This field is subdivided into 
five fields, described in Table C-6. (word) 

ACR$W_LENGTH 

Total length of the packet, in bytes, (word) 

Table C-6 ACR$W TYPE Fields in an Information Packet Header 

Symbolic Offset 

Description 


ACR$V_TYPE 


Identifies this header as a packet header. This bit must be 1 
(1 bit) 

Identifies the type of the packet. The six packet types (7 bits) 
are: 


ACR$V_SUBTYPE 
ACR$V_VERSION 
ACR$V_CUSTOMER 


Symbol 

Description 

ACR$K_FILENAME 

File name packet 

ACR$K_ID 

Identification packet 

ACR$K_IMAGENAME 

Image name packet 

ACR$K_PRINT 

Print resource packet 

ACR$K_RESOURCE 

Resource packet 

ACR$K USER DATA 

User data packet 


Identifies the packet subtype; reserved for future use. (4 bits) 
See Table C-3. 

See Table C-3. 


C.1.2.2 File Name Packet (ACR$K_FILENAME) 

The file name packet contains the name of the accounting file. Figure C—3 shows 
the format of the file name packet. Table C-7 describes the field contained in the 
packet. See Section C.1.2.1 for information on the packet header. 

Figure C-3 Format of a File Name Packet 
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Table C-7 Data Fields in a File Name Packet 


Symbolic Offset 

Description 

ACR$T_FILENAME 

Name of the file (counted ASCII string that gives full file 

specification). 


C.1.2.3 Identification Packet (ACR$KJD) 

The identification packet identifies the process that caused the record to be 

logged. 

Figure C-4 shows the format of the identification packet. Table C-8 describes the 
fields contained in the packet. See Section C.1.2.1 for information on the packet 
header. 

Figure C-4 Format of an Identification Packet 
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Table C-8 Data Fields in an Identification Packet 

Symbolic Offset Description 


ACR$L PID 

ACR$L_OWNER 

ACR$L_UIC 

ACR$Q_PRIV 

ACR$B_PRI 

ACR$B_IDFLGS 

ACR$W_USERNAME 


Process identification (PID) of the process, (longword) 

PID of the parent process, (longword) 

UIC of the process. The UIC can be addressed as two separate 
ACR$W_MEM for the member number, and ACR$W_ 
GRP for the group number, (longword) 

Privileges held by the process, (quadword) 


Base priority of the process, (byte) 

Flags byte; full address and full name present if low bit is set 


Offset to counted ASCII string containing the user name of the 
process, (word) 


ACR$W_ACCOUNT 


Offset to counted ASCII string containing the account name of 
the process, (word) 


ACR$ W_N ODENAME 
ACR$W_TERMINAL 


Offset to counted ASCII string containing the Phase W node 
name of the remote process, (word) 

Offset to counted ASCII string containing the terminal name 
(word) 


ACR$ W_J OBNAME 
ACR$L_JOBID 

ACR$W_QUEUE 

ACR$W_NODEADDR 

ACR$W_REMOTEID 

ACR$W_FULLADDR 

ACR$W_FULLNAME 


Offset to counted ASCII string containing the job name, (word) 

Identification of the print or batch job (queue entry number) 
(longword) 

Offset to counted ASCII string containing the name of the 
queue with which a batch or print job is associated, (word) 

Offset to a counted binary string containing the Phase W 
remote node address, (word) 

Offset to counted ASCII string containing the remote ID of the 
remote process (varies with network implementation and use) 
(word) 

Offset to a counted binary string containing the complete 
remote node network address. On a DECnet/OSI systen, this 
is the remote node’s NSAP address. 

Offset to a counted ASCII string containing the complete 
remote node name. On a DECnet/OSI system, this is the 
remote node’s full name. 


C.1.2.4 Image Name Packet (ACR$K_IMAGENAME) 

The image name packet contains the name of the image executed by the identified 
process. 

Figure C-5 shows the format of the image name packet. Table C-9 describes the 
field contained in the packet. See Section C. 1.2.1 for information on the packet 
header. 
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Figure C-5 Format of an Image Name Packet 
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Table C-9 Data Fields in an Image Name Packet 


Symbolic Offset 

Description 

ACR$T_IMAGENAME 

Name of the image (counted ASCII string that gives full file 

specification). 


C.1.2.5 Print Resource Packet (ACR$K_PRINT) 

The print resource packet contains information about print jobs. 

Figure C-6 shows the format of the print resource packet. Table C-10 describes 
the fields contained in the packet. See Section C. 1.2.1 for information on the 
packet header. 


Figure C-6 Format of a Print Resource Packet 


ACR$W_LENGTH ACR$W_TYPE 


Packet r 
Header \ 


Data y 
Fields ^ 


Length 


Type 


Job Status 


Queue Time 
(8 Bytes) 


Begin Time 
(8 Bytes) 


Symbiont Time 


Pages 


QIO Count 


GET Count 


ACR$L_PRINTSTS 

ACR$Q_QUETIME 

ACR$Q_BEGTIME 

ACR$L_SYMCPUTIM 

ACR$L_PAGECNT 

ACR$L_QIOCNT 

ACR$L_GETCNT 
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C.1.2.6 


Table C-10 Data Fields in a Print Resource Packet 


Symbolic Offset 

Description 

ACR$L PRINTSTS 

ACR$Q_QUETIME 

ACR$Q_BEGTIME 

ACR$L_SYMCPUTIM 

ACR$L_PAGECNT 

ACR$L_QIOCNT 

ACR$L_GETCNT 

Status of the print job. (longword) 

Time the job was queued. (64-bit absolute time) 

Time the job was started. (64-bit absolute time) 

Symbiont CPU time (always zero), (longword) 

Number of pages printed, (longword) 

Number of QIOs issued to the printer, (longword) 

Number of GETs from the file that was printed, (longword) 


Resource Packet (ACR$K_RESOURCE) 

The resource packet contains information about the identified process. 


Figure C-7 shows the format 
fields contained in the packet, 
header. 


of a resource packet. Table C-ll describes the 
See Section C. 1.2.1 for information on the packet 


Figure C-7 Format of a Resource Packet 

ACR$W_LENGTH ACRSWTYPE 


ACR$Q_LOGIN 

ACR$L_STATUS 

ACR$LJMGCNT 

ACR$L_CPUTIME 

ACR$L_FAULTS 

ACR$L_FAULTIO 

ACR$L_WSPEAK 

ACR$L_PAGEFL 

ACR$L_DIOCNT 

ACR$L_BIOCNT 

ACR$L_VOLUMES 

ACR$L_VP_CPUTIME 


Packet f 
Header 1 


Data j 
Fields * 


\_ 


Length Type 

Start Time 
(8 Bytes) 

Status 

Image Count 

CPU Time 

Page Faults 

Fault I/O 

Working Set Peak 

Page File 

Direct I/O 

Buffered I/O 

Volumes Mounted 

Vector CPU Time 
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Table C-11 Data Fields in a Resource Packet 


Symbolic Offset 

ACR$Q_LOGIN 

ACR$L_STATU S 

ACR$L_IMGCNT 

ACR$L_CPUTIME 

ACR$L_FAULTS 

ACR$L_FAULTIO 

ACR$L_W SPEAK 

ACR$L_PAGEFL 

ACR$L_DIOCNT 

ACR$L_BIOCNT 

ACR$L_VOLUMES 

ACR$L_VP_CPUTIME 


Description ______ 

64-bit absolute time at which the image was run or the process 

was created, (quadword) 

Final exit status of the image, or for a process, the final status 
of the last image executed in the process, (longword) 

Number of images run by the process, (longword) 

Total CPU time used by the image or process, measured in 
units of 10 milliseconds. This includes any vector CPU time, 
(longword) 

Number of hard and soft page faults incurred by the image or 
process, (longword) 

Number of hard page faults incurred by the image or process, 
(longword) 

Maximum working set size used by the image or process, 
(longword) 

Maximum page file usage, (longword) 

Number of direct I/Os made by the image or process, 
(longword) 

Number of buffered I/Os made by the image or process, 
(longword) 

Number of volumes mounted by the image or process, 
(longword) 

Vector CPU time used by the image or process, measured in 
units of 10 milliseconds, (longword) 


C.1.2.7 User Data Packet (ACR$K_USER_DATA) 

The user data packet contains an accounting message sent by the $oJNUd c 
system service. 

Figure C-8 shows the format of the user data packet. Table C-12 describes the 
fields contained in the packet. See Section C.l.2.1 for information on the packet 

header. 
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Figure C-8 Format of a User Data Packet 


ACR$W_LENGTH ACR$W_TYPE 



ZK-0965-GE 


Table C-12 Data Fields in a User Data Packet 


Symbolic Offset 

Description 

ACR$T USER DATA 

Up to 255 bytes of data (counted string). 
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ANALYZE/DISK_STRUCTURE performs the verification of a volume or volume 
in eight distinct stages. During these stages, ANALYZE/DISK STRUCTURE 
compiles information that is used in reporting errors and performing repairs. 

Before ANALYZE®ISK_STRUCTURE can proceed with each stage, it must 
perform the following four initialization functions: 

Read the device name, validate access to the device, and save the device name 

Read the user-specified file names for the /LIST and /USAGE qualifiers if 
specified, and open the files H ’ 


• Assign all appropriate channels to the device being checked 

Wnte-lock the volume set to prevent simultaneous updates 

Tfe following sections describe the eight stages that ANALYZE/DISK_ 
STRUCTURE goes through while verifying a disk. These descriptions assume 
the /REPAIR qualifier in the command. An annotated 
ANALYZE/DISK.STRUCTURE listing is included at the end of this appendix. 


D.1 Stage 1 


In Stage 1 ANALYZE/DISK.STRUCTURE gathers various volume information 
(such as cluster size, volume labels, and the number of volumes in the set) 
rom several reserved files, verifies the information for accuracy, reports all 
discrepancies, and corrects problems discovered during this stage. 

/^JALYZE/DISK_STRUCTURE identifies the volume and all the characteristics 

axtatatXa^ 6 by USmg the P arameter s of the home block in INDEXF.SYS. When 
ANALYZE/DISK_STRUCTURE confirms this information, it builds a current 

ZuSCBTof I fS S S?s mem0ry a " d rcadS a " d VerifieS ‘ he ^ 


ANALYZE/DISK_STRUCTURE then compares the volume-set attributes for 

vnVSw°Q fVO i SET ' SYS L in mem0ry t0 the attriba tes listed in the version of 
VULSEI.SYS resident on the volume, reports discrepancies, and corrects errors 


D.2 Stage 2 


o^o ANALYZE/DISK - STRUCTURE c °P ies current version of 
QUOIA.SYS into working memory, and establishes the structure on which 
another QUOTA.SYS file is built during subsequent stages. In Stage 7, these 
copies are compared with each other and inconsistencies are reported. 
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ANALYZE/DISK_STRUCTURE—Stage Checks 
D.3 Stage 3 


D.3 Stage 3 

o, _ o checks consist of ANALYZE/DISK_STRUCTURE operations that use the 
reserved file INDEXF.SYS. During Stage 3, ANALYZE/DISK_STRUCTURE opens 
INDEXF.SYS, reads each file header, and completes the following steps. 

• Validates each file’s FID, and confirms that all files can be retrieved through 
the FID 

• Validates the header and the revision date of each file 


• Validates any extension headers of each file 

• Confirms that each segment number reflects the proper sequence of extension 
headers 

ANALYZE/DISK.STRUCTURE also does the following during Stage 3: 

• Builds a map of header linkage so that ambiguities can be detected 

. Determines the high block (HIBLK) and end-of-file block (EFBLK) 

record attributes and compares these values with the recorded values in 

INDEXF.SYS 


• Checks the high-water mark (HIWATERMARK) 

While performing these checks, ANALYZB7DISKJ3TRUCTUKE builds several 
maps that it uses in subsequent stages. Table D-l briefly describes each map 
built in Stage 3. 


Table D-1 Stage 3 Maps 

Bitmap _ 

Valid file numbers 
Lost file numbers 
Directory files 
Extension linkages 
Multiply-allocated clusters 

Allocated clusters 
System map 
Valid file backlink 
Invalid backlink 


Function 

The current state of the bitmap for INDEXF.SYS 

All the valid file numbers not yet found in a directory 

List of all directory files 

List of all valid extension headers 

List of all clusters that are referenced by more than 

one header 

All allocated clusters on the volume (or volume set) 
The new storage bitmap 
A map of all valid file backlinks 
A map of all invalid backlinks 


D.4 Stage 4 


In Stage 4, ANALYZE/DISK_STRUCTURE builds a current version of 
BITMAP.SYS using the maps built during Stage 3. In addition, ANALYZE 
/DTSK STRUCTURE reports any discrepancies between the headers’ maps 
and the storage bitmap. In Stage 4, ANALYZE/DISK.STRUCTURE does the 
following: 


• Copies BITMAP.SYS into working memory 

. Compares the corrected version of BITMAP.SYS with a map built from 
INDEXF.SYS 
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ANALYZE/DISK_STRUCTURE—Stage Checks 

D.4 Stage 4 


• Writes a corrected version of BITMAP.SYS to disk 

• Reports multiply-allocated clusters 


D.5 Stage 5 

In this stage, ANALYZE/DISK.STRUCTURE completes a pass of all entries in 
the invalid backlink map. ANALYZE/DISK_STRUCTURE searches the directory 
hierarchy of the volume to confirm that all files included in INDEXF.SYS are 
retrievable through the directory structure. In addition, ANALYZE/DISK_ 
STRUCTURE identifies lost directories and attempts to reestablish valid 
backlinks to those directories. 

In Stage 5, ANALYZE/DISK_STRUCTURE does the following: 

Confirms the locations of all directories listed in the directory map (compiled 
in Stage 3) and the subsequent files in those directories 

• Enters all directories indicated as lost and locates a valid parent (if any) 

D.6 Stage 6 


Stage 6 is essentially a cleanup operation for lost file headers. Following Stage 5 
ANALYZE/DISK_STRUCTURE is left with a list of files that are truly lost—files' 
that have backlinks to nonexistent directories. These files were not traceable 
through the directory structure. ANALYZE/DISK_STRUCTURE is also left with 
a list of files with bad backlinks; these files are traceable through the directory 
structure, but the backlinks of the files do not point back to the directory that 
contains them. 


During Stage 6, ANALYZE/DISK_STRUCTURE does the following: 

• Checks the backlink map to locate all files with invalid backlinks, then 
repairs backlinks 

• Checks the lost file bitmap for lost files and places lost files in [SYSLOST] if 
you specified /REPAIR 

• If you specified the /USAGE qualifier, creates an entry for each lost file 


D.7 Stage 7 

In this stage, ANALYZE/DISK_STRUCTURE compares the values stored in the 
quota file built during Stage 2 with those stored in the reserved file QUOTA SYS 
During Stage 7, ANALYZE/DISK_STRUCTURE opens QUOTA.SYS and performs 
the following operations: 

• Compares the block usage for each UIC listed in QUOTA.SYS to parallel 
statistics listed in the copy of QUOTA.SYS built in Stage 2 

• Modifies QUOTA.SYS such that values in QUOTA.SYS match values in the 
copy built in Stage 2 

• Closes QUOTA.SYS 
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D.8 Stage 8 


D.8 Stage 8 

Throughout the first seven stages, ANALYZE/DISK.STRUCTURE places 
operations that cannot be performed during a particular stage on a deferred 
list. The list includes FIDs sorted by operation. In Stage 8, ANALYZE/DISK_ 
STRUCTURE performs all operations stored on the deferred list. In Stage 8, 
ANALYZE/DISK_STRUCTURE does the following: 

• Removes an FID from the deferred list, renames the file, and adds the file to 
SYSLOST.DIR or to a user-specified directory 

• Updates QUOTA.SYS to reflect all additional blocks used by the UIC that 
received the lost file 

• Updates VOLSET.SYS to correct inconsistencies discovered during previous 
ANALYZE/DISK_STRUCTURE stages 

D.9 Annotated Example 

Example D-l is an annotated example of an ANALYZE/DISK_STRUCTURE 
session. The command used to generate this example did not include the 
/REPAIR qualifier. 

Example D-1 ANALYZE/DISK_STRUCTURE—Annotated Example 

%VERIFY-I-BADHEADER, file (487,173,1) MAIL$0004008EEAEE0572.MAI;1 O 
invalid file header 

%VERIFY-I-BADHEADER, file (531,112,1) MAIL$0004008EEFBB198B.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (589,104,1) MAIL$0004008EEAF199B9.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (604,157,1) MAIL$0004008EF12C3B28.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (674,247,1) MAIL$0004008EF6053C9B.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (688,41,1) MAIL$0004008EF608AFF4.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (689,135,1) MAIL$0004008EEE445A31.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (750,71,1) MAIL$0004008EEED19ADF.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (753,217,1) MAIL$0004008EE7C4A017.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (780,236,1) MAIL$0004008EF777ACA8.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (852,57,1) MAIL$0004008EF06C15F6.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (856,44,1) MAIL$0004008EE7D2520D.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (1059,42,1) MAIL$0004008EEB045608.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (1134,76,1) MAIL$0004008EE9EC806D.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (1316,147,1) MAIL$0004008EEEDA734F.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (1350,74,1) MAIL$0004008EE89BA8B0.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (1351,64,1) MAIL$0004008EEB09B036.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (1490,104,1) MAIL$0004008EE8B448B0.MAI;1 
invalid file header 

%VERIFY-I-BADHEADER, file (1493,106,1) LASTNOTIC.NIL;1 
invalid file header 


(continued on next page) 
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ANALYZE/DISK_STRUCTURE—Stage Checks 

D.9 Annotated Example 

Example D-1 (Cont.) ANALYZE/DISK_STRUCTURE—Annotated Example 

%VERIFY-I-BADHEADER, file (1548,204,1) MAIL$0004008EF7B4D1B8.MAI-1 
invalid file header 

%VERIFY-I-BADHEADER, file (1613,61,1) MAIL$0004008EECEE4BA5 MAI-1 
invalid file header ' 

%VERIFY-I-BADHEADER, file (1812,81,1) MAIL$0004008EE7DF05EC.MAI•1 
invalid file header ’ ' 

%VERIFY-I-BADHEADER, file (1848,26,1) MAIL$0004008EF78659B9.MAI-1 
invalid file header 

%VERIFY-I-BADHEADER, file (1983,34119,1) MAIL$0004008EE7E49C13.MAI•1 
invalid file header 

% VERIFY-1-BADHEADER, file (1987,33907,1) REMIND.CAL-9 
invalid file header 

%VERIFY-I-BADHEADER, file (2196,123,1) MAIL$0004008EE6FA2DC9 MAI-1 
invalid file header 

%VERIFY-I-BADHEADER, file (2372,125,1) MAIL$0004008EF06339F9.MAI•1 
invalid file header 

%VERIFY-I-BADHEADER, file (2569,67,1) MAIL$0004008EF2BF0C15 MAI-1 
invalid file header 

%VERIFY-I-BADHEADER, file (2605,72,1) MAIL$0004008EE856FC73 MAI-1 
invalid file header 

%VERIFY-I-BADHEADER, file (2616,70,1) MAIL$0004008EF063C04F MAI-1 
invalid file header 

%VERIFY-I-BADHEADER, file (2774,29818,1) LASTNOTIC.NIL-1 
invalid file header 

%VERIFY-I-ALLOCCLR, blocks incorrectly marked allocated © 

LBN 442398 to 445538, RVN 1 

%VERIFY-1-BADHEADER, file (487,0,1) MAIL$0004008EEAEE0572 MAI-1 © 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (487,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (531,0,1) MAIL$0004008EEFBB198B MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (531,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (589,0,1) MAIL$0004008EEAF199B9 MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (589,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (604,0,1) MAIL$0004008EF12C3B28 MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (604,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (674,0,1) MAIL$0004008EF6053C9B MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (674,0,1) 
lost extension file header 

% VERIFY-1-BADHEADER, file (688,0,1) MAIL$0004008EF608AFF4 MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (688,0,1) 
lost extension file header 

% VERIFY-1-BADHEADER, file (689,0,1) MAIL$0004008EEE445A31 MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (689,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (750,0,1) MAIL$0004008EEED19ADF MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (750,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (753,0,1) MAIL$0004008EE7C4A017 MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (753,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (780,0,1) MAIL$0004008EF777ACA8 MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (780,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (852,0,1) MAIL$0004008EF06C15F6.MAI;1 


(continued on next page) 
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Example D-1 (Cent.) ANALYZE/DISK_STRUCTURE Annotated Example 

invalid file header 
%VERIFY-I-LOSTEXTHDR ; file (852,0,1) 

lost extension file header - 

%VERIFY-I-BADHEADER, file (856,0,1) MAIL$0004008EE7D2520D.MAI;1 
invalid file header 
%VERIFY-1'-LOSTEXTHDR, file (856,0,1) 

lost extension file header . 

%VERIFY-1-BADHEADER, file (1059,0,1) MAIL$0004008EEB045608.MAI;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1059,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (1134,0,1) MAIL$0004008EE9EC806D.MAI;1 
invalid file header 
% VERIFY-1-LOSTEXTHDR, file (1134,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (1316,0,1) MAIL$0004008EEEDA734F.MAI; 

invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1316,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (1350,0,1) MAIL$0004008EE89BA8B0.MAI;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1350,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (1351,0,1) MAIL$0004008EEB09B036.MAI;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1351,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (1490,0,1) MAIL$0004008EE8B448B0.MAI;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1490,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (1493,0,1) LASTNOTIC.NIL;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1493,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (1548,0,1) MAIL$0004008EF7B4D1B8.MAI;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1548,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (1613,0,1) MAIL$0004008EECEE4BA5.MAI;1 
invalid file header 

%VERIFY-I-LOSTEXTHDR, file (1613,0,1) 
lost extension file header 

%VERIFY-1-BADHEADER, file (1812,0,1) MAIL$0004008EE7DF05EC.MAI;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1812,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (1848,0,1) MAIL$0004008EF78659B9.MAI;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1848,0,1) 

lost extension file header _ 

%VERIFY-I-BADHEADER, file (1983,0,1) MAIL$0004008EE7E49C13.MAI?1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1983,0,1) 
lost extension file header 
%VERIFY-I-BADHEADER, file (1987,0,1) REMIND.CAL;9 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (1987,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (2196,0,1) MAIL$0004008EE6FA2DC9.MAI;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (2196,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (2372,0,1) MAIL$0004008EF06339F9.MAI;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (2372,0,1) 
lost extension file header 


(continued on next page) 
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D.9 Annotated Example 


Example D-1 (Cont.) AN ALYZE/DIS K_STRUCTU R E—An notated Example 

%VERIFY-I-BADHEADER, file (2569,0,1) MAIL$0004008EF2BF0C15.MAI•1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (2569,0,1) 
lost extension file header 

%VERIFY-I-BADHEADER, file (2605,0,1) MAIL$0004008EE856FC73 MAI-1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (2605,0,1) 
lost extension file header 

%VERIFY-1-BADHEADER, file (2616,0,1) MAIL$0004008EF063C04F.MAI•1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (2616,0,1) 
lost extension file header 

%VERIFY-1'-BADHEADER, file (2774,0,1) LASTNOTIC.NIL;1 
invalid file header 
%VERIFY-I-LOSTEXTHDR, file (2774,0,1) 
lost extension file header 

%VERIFY"I "baddtr pnt " - nVa |-H SS ^ ent ^ ication in directory entry [ALLWAY]NOTES. LOG; 25 © 

%VERIFY-I-BADDIRENt' invalid Si! ^® n ^^ Ca ^ on “ directory entry [BLAIN.BOOTS]LOADER.OBJ; 1 

%VERIFY-I-BADDIRe 5' invalid Si! S!r “ .° n ln ^rectory entry [BLAIN.BOOTS]SYSGEN.OBJ; 1 

% VERIFY t RjnnlmZ' - IS SI identification in directory entry [BLAIN]MAIL_20600841.TMP-1 

%VERIFY-I-BMDIRENt' invalid Si! ldfSf 1C % tl0n ln ^ irector y entr y [BLAINJNETSERVER.LOG; 181 

%VERIFY-I-BADDIRENt' IZlld Si! SS Ca S° n ln ^ lrector y entr y [BLAIN]NETSERVER.LOG;180 

%VERIFY-I-BADDIRENt' invalid Si! S SSZ- 0 " •" dlrector y entry [BLAIN]NETSERVER.LOG; 179 

%VERIFY-I-BADDIRENt' IZlld Si! S SSZ- 0 " ln dlreCtor y entr y tBLAIN]NETSERVER.LOG; 178 

%VERIFY-I-BADDIRENt' IZlld Si! -SZSZ- 011 m directory entry [BLAINJNETSERVER.LOG; 170 

%VERIFY-I-BADDIRe 5' Invalid Si! ld!!SS! a S° n “ ^ rect0ry entry [BOEMUS.MAIL]MAIL$0004008EF94A72A0.MAI;1 
%VERIFY-I-BADDIRENt' IZlld Si! dSSS" ln ^ rect °ry “try [BOEMUSJNETSERVER.LOG; 10 
% VERIFY T raZtSS'; a f identification m directory entry [ BOEMUS ] UPDATE. LOG; 1 
iKralSI i'BACKLINK, incorrect directory back link [CALGON.GER]OBJ.DIR;l 

%VERIFY-I~BACKi I Tmr T ' . lnvalld f r| e identification in directory entry [CALGON]T.TMP;l 
%VERIFy’Sm™Iot lnCOrrec ^ directory back link [CLABIN.BACKUP.TMPSRC]BACKDEF.SDL;1 
incorrect directory back link [CLABIN.BACKUP.TMPSRC]COMMON.REQ;l 
%VERIFv'l'BAnn™ incorrect directory back link [CLABIN.BACKUP.TMPSRC]DUMMY.MSG-1 
% VERIFY I BADdIrtot' IZlS SS -S^-S^- 011 m directory entry [CLABIN. NMAILJNMAIL.LOG; 77 
%VERIFY-I-BADDIRENt' Invalid SS S^SS 0 ®^ 0 " m directory entry [CLABIN.NMAILJNMAIL.LOG;76 
S f F - - Z ' Invalid Si! iZSSZ- 011 in directory entry [DESIN.8800]2840HT86.GNC;1 
% VERIFY I RAnmRFOT' I! Vd SI i dent iii cat ion in directory entry [DESIN.8800]2840TP86.GNC;1 

%VERIFY-I-BADDIRENt' Invalid Si! Id^SS^S 0 " “ S reCt0ry entry r DG ™E.MAIL]MAIL$0004008EF94A79B3.MAI; 1 
%VErIfy I Z p™' Sd SI ldent ifi cat i°n in directory entry [DOWNE.PRO]MORT.OBJ;15 

% VERIFY I BADdIrfnt ' IZlS SS S^-S^- 0 " in directory entry [DOWNE.PROJOUTPUT.LOG; 3 6 

% VERIFY I BADdIrfnt' IZlS SS • SS-S^ 10 " directory entry [DOWNE.PROJOUTPUT.LOG; 35 
WERIFY-I-BADDIRENT' IZlld SS ^ en SS Ca S° n ln dlreCtory entr y [DOWNE. PRO] OUTPUT.LOG; 34 
% VERIFY I RAnmRFMT' Id SI i dent i^i cat i°n in directory entry [DOWNE. PRO] OUTPUT. LOG; 33 

%lffiRIFY-I-BADDIRENT' Invalid SS -ZSSZ- 0 " “ directory “try [DOWNE.PROJOUTPUT.LOG;32 
%VERTFY T RAnmRRMS • Sd SI i dent iflotion in directory entry [DOWNE.PRO]OUTPUT.LOG;31 

% VERIFY I RAnnlRFMT' • Sd SI 6 identification in directory entry [DOWNE. PRO] OUTPUT. LOG; 30 

SlFY’S^m^' IS SI* ldentl fi cat i°n in directory entry [GAMBLE]CONFLICTS.LIS;l 
% lnvad i d ^| e identification m directory entry [GAMBLE.DOC]SMP.LOCK;6 

% VERIFY I BAnnlRFNT' ltlVa Sd SI* ! dentl ^ cat ! on in directory entry [ GAMBLE ] NETSERVER. LOG; 5 
SrIFY-I-BMDIRENt' Z ld SS lden SS Ca S° n ln direct0ry entry RAMBLE.NMAIL]NMAIL.LOG;22 
% VERIFY T RAnnlmZ' “ IS SI ! dent S 1Cat “ n ln directory entry [GAMBLE. NMAIL1NMAIL.LOG; 21 
%VERIFY-I-BADDIRENt' iZ Id Si! ld!!SS Ca S° n l n S reCt0ry entry t^iBLEY.MAIL]MAIL$0004008EF94A7B70.MAI;1 

xsizs: siSd s: Siiiss i: d,tee “ ry “ try 

directory entry [GILLEYJNETSERVER.LOG;656 

%VERIFY-I-BADDIRENT, invalid file identification in directory entry [HALL12 LOG-33 
«« invalid file identification in director^ !!t? [SJ 
„ 1 BADD ™, invalid file identification in directory entry [HALL]2.LOG-31 

%VERIFY-I-BADDIRENT, invalid file identification in directory entry [HALL]2 LOG-30 

%VERIFY-1-BADDIRENT, invalid file identification in direct!? “t? E 2 WG-IS 

%VERIFY-I-BADDIRENT, invalid file identification in directo? !Zy [HALL12.LOG-28 

inva }^ f j le identification in directory entry [HALL]2.LOG;27 
l BADDIRENT / invalid file identification in directory entry [HALL]2.LOG-26 

^X? FFF 3~J” BADDIRENT ' invalid f S le identification in directory entry [HALL]2.LOG-25 

™ 3- - BADDIRENT ' i nval; !- d identification in directory entry [HALL]2.LOG-24 

%VERIFy"i"bADDIRENt' lnVa !S SI® S enti S Cati0n in directory entry [NAMOLLY]NETSERVER.LOG;2 
RIFY I BADDIRENT, invalid file identification in directory entry [NAMOLLY]NETSERVER.LOG;1 


(continued on next page) 
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ANALYZE/DISK_STRUCTURE—Stage Checks 
D.9 Annotated Example 


Example 

%VERIFY-I- 
%VERIFY-I- 
%VERIFY-I- 
%VERIFY-I- 
%VERIFY-I- 
%VERIFY-I 
%VERIFY-I 
%VERIFY-I 
%VERIFY-I 
%VERIFY-I 
%VERIFY-I 
%VERIFY-I 
%VERIFY-I 


D-i (Cont.) ANALYZE/DISK.STRUCTURE—Annotated Example 

:SS: iSSS™ £ S5SS S !SS 5 Si— 

-BADDIRENT, invalid file identification in directory entry 

-BADDIRENT, invalid file identification in directory entry [ ^ . mail]MAI l $0 004008EF94D75EB.MAI,-1 

-BADDIRENT, invalid file identification in d t y y THOMASMAIL]MAIL$ oo0400 8 E F 955DDF3.MA I; 1 

:SS; iSid Sue SIS in SS entrj [THOMAS.MAIL]MAIL$0004008EFD118B44 .MAI; i 

-LOSTSCAN, due to directory errors, lost files will not be entered © . a 

-INCQUOTA, QUOTA.SYS indicates 69663 blocks used, actual use > is 69740 blocks for [11,402] © 
-INCQUOTA, QUOTA.SYS indicates 1764 blocks used, actual use is 1770 flocks for [12, 

-INCQUOTA, QUOTA.SYS indicates 0 blocks used, actual use is 31 blocks for [ 1, 


O ANALYZE/DISK_STRUCTURE has completed the first two stages, and is 
beginning Stage 3. Stage 1 involves collection and verification of various 
volume information. ANALYZE/DISK_STRUCTURE found no problems with 
volume information. In Stage 2, ANALYZE/DISKJ3TRUCTURE copies the 
current version of QUOTA.SYS to working memory, and builds the structure 
on which a new copy is built during subsequent stages. The firs * 
message is produced by Stage 3. Stage 3 uses the reserved file INDEXr.SYb 
to locate a variety of file problems. Here, Stage 3 detects a number of invalid 
file headers. Note that the error message includes the FID and the file name. 

© This error message is produced during Stage 4, during which ANALYZE 
/DISK.STRUCTURE builds a current version of BITMAP.SYS, resolves 
multiple references to extension headers, and corrects discrepancies in the 
map sections of headers. Here, ANALYZE/DISK_STRUCTURE has found 
that the specified logical blocks on the specified relative volume were marked 
allocated in the storage bit map, but were not allocated to a file. 

0 This message marks the beginning of Stage 5. Here, messages stating ‘lost 
extension file header” and “invalid file header” indicate that ANALYZE 
/DISK_STRUCTURE is performing a pass of all entries placed on the invalid 
backlink map. This map was created in Stage 3. 

O This message marks the beginning of the second phase of Stage 5, in which 
ANALYZE/DISK_STRUCTURE confirms that all files in INDEX.SYS are 
retrievable through the directory structure. Here, the series of “invalid file 
identification ...” messages indicates those directory entries that did not 
contain a valid file identification. 

0 This message is produced by Stage 6, which is essentially a cleanup phase 
for lost files. This message indicates that ANALYZE/DISK_STRUCTURE 
encountered errors during the directory scan that were reported in previous 
messages. As a result, the file is not entered in directory [SYSLOST], 


© Here ANALYZE/DISK_STRUCTURE begins Stage 7, in which it compares 
values stored in the quota file built during Stage 2 with values in the reserved 
file QUOTA.SYS. The last three messages here indicate discrepancies between 

the two files. 

Note that no messages were produced during Stage 8. During Stage 8, 

ANALYZE/DISK_STRUCTURE executes all operations placed on the deferred 
list, and if you specified /REPAIR, updates QUOTA.SYS and VOLSET.SYS as 
necessary. 
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ANALYZE/DISK_STRUCTURE—Usage File 


When you specify the /USAGE qualifier, ANALYZE/DISKJSTRUCTURE creates 
a disk usage accounting file. The first record of this file, the identification record 
contains a summary of the disk and volume characteristics. The identification 
record is followed by many file summary records, one record for each file on the 
disk. Each file summary record contains the owner, size, and name of a file. 


The identification record is characterized by the type code USG$K IDENT in 

the USG$B_TYPE field of the record. Table E-l contains a description of all the 
fields m this record. 


Table E-1 Identification Record Format (Length USG$KJDENT LEN) 


Field 

Meaning 

USG$L SERIALNUM 

USG$T_STRUCNAM 

Serial number of the volume. This is an octal longword value. 

Volume set name (if the volume is part of a volume set). 

For a Files-11 Structure Level 1 volume, this field contains 
binary zeros; for a Files-11 Structure Level 2 volume that 
is not part of a volume set, this field contains spaces. The 
length of this field is USG$S_STRUCNAME. 

USG$T_VOLNAME 

name of rela hve volume 1. The length of this field is 
USG$S_VOLNAME. 

USG$T_OWNERNAME 

Volume owner name. The length of this field is USG$S 
OWNERNAME. 

USG$T_FORMAT 

Volume format type. For a Files-11 Structure Level 1 
volume, this field contains “DECFILE11A”; for a Files-11 
Structure Level 2 volume, this field contains “DECFILE11B” 
The length of this field is USG$S_FORMAT. 

USG$Q_TIME 

Quadword system time when this usage file was created The 
length of this field is USG$S TIME. 


Each file summary record is characterized by the type code USG$K_FILE in the 
USG$B_TYPE field of the record. Table E-2 contains a description of all the 
fields in these records. 
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ANALYZE/DISK_STRUCTURE—Usage File 


Table E-2 File Reco rd Format (Length USG$K_FILE_LEN) 

Field Meaning 


USG$L_FILEOWNER 

USG$W_UICMEMBER 

U SG$W_UICGROUP 

USG$L_ALLOCATED 

USG$L_USED 

USG$W_DIR_LEN 

USG$W_SPEC_LEN 


File owner UIC. This can be considered as a single longword 

value or as two word values (USG$W_UICMEMBER and 
USG$W_UICGROUP). 

The member field of the file owner UIC. This is an octal word 
value. 

The group field of the file owner UIC. This is an octal word 
value. 

Number of blocks allocated to the file, including file headers. 
This is a decimal longword value. 

Number of blocks used, up to and including the end-of-file 
block. This is a decimal longword value. 

Length of the directory string portion of USG$T_FILESPEC, 
including the brackets. This is a decimal word value. 

Length of the complete file specification in USG$T_ 
FILESPEC. This is a decimal word value. 


USG$T_FILESPEC 


File specification, in the following format: 


[dir]nam.typ;ver 

This field is of variable length. A file that has more than 
one directory entry is listed under the first file specification 
found. A lost file has an empty directory string “[]” and 
the file name is taken from the file header. In some cases 
this information does not exist; you must take this into 
consideration when you write application programs to process 
the nsave file. The length of this field is USG$S FILESPEC. 


The symbolic names referenced in both the identification and the file summary 
records are defined in the system definition macro $USGDEF. The length of the 
identification record is USG$K_IDENT_LEN. The length of a file summary record 
is USG$K_FILE_LEN. 
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Security Audit Message Format 


This appendix describes the format of the auditing messages 

m ty / uditing log file - The default audit log 

file SECURITY.AUDIT$JOURNAL is created by default in the 
SYS$COMMON:[SYSMGR] directory. 

Each security audit record consists of a header packet followed by one or more 
data packets as shown in Figure F-l. The number of data packets depends on 
,. y ? e m °™ iatl ° n being sent. This appendix describes the format of the 
audit header and its data packets as well as the contents of the data packets. 

Figure F-1 Format of a Security Audit Message 


Record Subtype 

Record Type 

Packet Count n 

Flags 

Version Unused 

Record Size 

Unused 

Unused 

Facility 

Unused 


Packet Type 

Packet Size 

Packet Data 


Packet Type 

Packet Size 


> Audit Header 




n Packets 
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Security Audit Message Format 
F.1 Audit Header Packet 


F.1 Audit Header Packet 

Table F—1 describes the fields contained in the audit header packet, illustrated in 
Figure F-2. 


Figure F-2 Audit Header Packet Format 


NSA$W RECORD SUBTYPE 

NSA$W_RECORD_TYPE 

NSA$W PACKET COUNT 

NSA$W_FLAGS 

NSA$C VERSION 3 Unused 

NSA$W_RECORD_SIZE 

Unused 

Unused 

NSA$W_FACILITV 

Unused 


ZK-0825A-GE 


Symbols representing the types or subtypes of security ® ve ^ sar ® llS ^' n TYpE 
Table F-2 For each audit event record type defined by NSA$WJtECORD TYPE, 
Sere is a record subtype defined by the symbol NSA$W_RECORD_SUBTYPE, 
which further defines the event. 


Table F-3 identifies any flags associated with the audited event. 

The symbol NSA$K_MSG_HDR_LENGTH defines the current size of the message 
header (in bytes). 


Table F-1 Description of the Audit Header Fields 

Field Symbolic Offset 


Type 

nsa$w_record_type 

Subtype 

NSA$W_RECORD_SUBTYPE 

Flags 

NSA$W_FLAGS 

Packet count 

NSA$W_PACKET_COUNT 

Record size 

NSA$W_RECORD_SIZE 

Version 

NSA$C_VERSION_3 


Contents 

Indicates the type of event that has occurred. See 

Table F-2 for details. 

Further defines the type of event that has 
occurred. See Table F—2 for details. 

Identifies any flags associated with the audited 
event. See Table F-3 for details. Reserved to 
Digital. (Word) 

Number of data packets in the audit record. 

(Word) 

Total size of the audit message; the size represents 
the header packet plus all its data packets. (Word) 

Indicates the version of the security auditing 
facility. The symbol NSA$C_VERSION_3 indicates 
the current version. (Byte) 

(continued on next page) 
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Security Audit Message Format 
F.1 Audit Header Packet 



Tbe facility code for the generated event. By 
default, this field is zero, indicating a system¬ 
generated event. (Word) 



Subtype and Meaning 

NSA$C_ALARM_STATE 

NSA$C_AUDIT_DISABLED 

NSA$C_AUDIT_ENABLED 

NSA$C_AUDIT_INITIATE 

NSA$C_AUDIT_LOG_FIRST 

NSA$C_AUDIT_LOG_FINAL 

NSA$C_AUDIT_STATE 

NSA$C_AUDIT_TERMINATE 

NSA$C_SNAPSHOT_ABORT 

NSA$C_SNAPSHOT_ACCESS 

NSA$C_SNAPSHOT_SAVE 

NSA$C_SNAPSHOT_STARTUP 

NSA$C_MSG_BREAKIN 

Subtype and Meaning 

NSA$C_BATCH 

NSA$C_DETACHED 

NSA$C_DIALUP 

NSA$C_LOCAL 

NSA$C_NETWORK 

NSA$C_REMOTE 

NSA$C_SUBPROCESS 

NSA$C_MSG_CONNECTION 

Subtype and Meaning 

NSA$C_CNX_ABORT 
NSA$C_CNX_ACCEPT 
NSA$C_CNX_DECNET_CREATE 
NSA$C_CNX_DECNET_DELETE 
NSA$C_CNX_DISCONNECT 
NSA$C_CNX_INC_ABORT 
NSA$C_CNX_INC_ACCEPT 
NSA$C_CNX_INC_DISCONNECT 
NSA$C_CNX_INC_REJECT 
NSA$C_CNX_INC_REQUEST 
NSA$C_CNX_IPC_CLOSE 
NSA$C_CNX_IPC_OPEN 
NSA$C_CNX_REJECT 
NSA$C_CNX_REQUEST 
NSA$C_MSG_INSTALL 

Subtype and Meaning 

NSA$C_INSTALL_ADD 

NSA$C_INSTALL_REMOVE 


Events enabled as alarms 

Audit events disabled 

Audit events enabled 

Audit server startup 

First entry in audit log (backward link) 

Final entry in audit log (forward link) 

Events enabled as audits 
Audit server shutdown 
System snapshot attempt has aborted 
Snapshot file access/deaccess 
System snapshot save in progress 
System booted from a snapshot file 

Break-in attempt detected 

Batch process 
Detached process 
Dialup interactive process 
Local interactive process 
Network server task 

Interactive process from another network node 
Subprocess 

Logical link connection or termination 

Connection aborted 

Connection accepted 

DECnet logical link created 

DECnet logical link disconnected 

Connection disconnected 

Incoming connection request aborted 

Incoming connection request accepted 

Incoming connection disconnected 

Incoming connection request rejected 

Incoming connection request 

Interprocess communication association closed 

Interprocess communication association opened 

Connection rejected 

Connection requested 

Use of the Install utility (INSTALL) 

Known image installed 
Known image deleted 


(continued on next page) 











Security Audit Message Format 
F.1 Audit Header Packet 



NSA$C_MSG_LOGFAIL 

Subtype and Meaning 

See subtypes for 

nsa$c_msg_breakin 

NSA$C_MSG_LOGIN 


Subtype and Meaning 

See subtypes for 

nsa$c_msg_breakin 

N S A$C_MSG_LOGOUT 

Subtype and Meaning 

See subtypes for 

nsa$c_msg_breakin 


N S A$C_MSG_MOUNT 

Subtype and Meaning 

NSA$C_VOL_DISMOUNT 
N S A$C_V OL_MOUNT 

NSA$C_MSG_NCP 


Login failure 


Successful login 


Successful logout 


Volume mount or dismount 

Volume dismount 
Volume mount 

Modification to network configuration database 


Subtype and Meaning 

NSA$C_NCP_COMMAND 

NSA$C_MSG_NETPROXY 

Subtype and Meaning 

NSA$C_NETPROXY_ADD 
NSA$C_NETPROXY_DELETE 
N S A$C_NETPROXY_MODIFY 

NSA$C_MSG_OBJ_ACCESS 

Subtype and Meaning 

NSA$C_OBJ_ACCESS 

NSA$C_MSG_OBJ_CREATE 

Subtype and Meaning 

NSA$C_OBJ_CREATE 

NSA$C_MSG_OBJ_DEACCESS 

Subtype and Meaning 

NSA$C_OBJ_DEACCESS 

NSA$C_MSG_OBJ_DELETE 

Subtype and Meaning 

NSA$C_OBJ_DELETE 

NSA$C_MSG_PROCESS 


Network Control Program (NCP) command issued 
Modification to network proxy database 

Record added to network proxy authorization file 
Record removed from network proxy authorization file 
Record modified in network proxy authorization file 

Object access attempted 

Access attempted to create, delete, or deaccess an object 
Object creation attempted 

Access attempted to create an object 
Object deaccessed 

Attempt to complete access to an object 
Object deletion attempted 

Object deletion attempted 

Process controlled through a system service 

(continued on next page) 
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Security Audit Message Format 
F.1 Audit Header Packet 



Subtype and 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C_ 

nsa$c_: 


Meaning 

PRC_CANWAK 

_PRC_CREPRC 

_PRC_DELPRC 

_PRC_FORCEX 

_PRC_GETJPI 

_PRC_GRANTID 

_PRC_RESUME 

_PRC_REVOKID 

.PRCjSCHDWK 

PRC_SETPRI 

PRC_SIGPRC 

PRC_SUSPND 

PRC.TERM 

PRC_WAKE 


NSA$C_MSG_PRVAUD 

Subtype and Meaning 

NSA$C_PRVAUD_FAILURE 

NSA$C_PRVAUD_SUCCESS 

NSA$C_MSG_RIGHTSDB 


Subtype and 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C 

NSA$C. 

NSA$C_MSG_ 


Meaning 

_RDB_ADD_ID 

_RDB_CREATE 

_RDB_GRANT_ID 

_RDB_MOD_HOLDER 

_RDB_MOD_ID 

_RDB_REM_ID 

_rdb_revoke_id 

.SYSGEN 


Subtype and Meaning 

NSA$C_SYSGEN_SET 

NSA$C_MSG_SYSTIME 

Subtype and Meaning 

NSA$C_SYSTIM_SET 

NSA$C_SYSTIM_CAL 

NSA$C_MSG_SYSUAF 

Subtype and Meaning 

NSA$C_SYSUAF_ADD 

NSA$C_SYSUAF_COPY 

NSA$C_SYSUAF_DELETE 

NSA$C_SYSUAF_MODIFY 

NSA$C_SYSUAF_RENAME 


Process wakeup canceled 
Process created 
Process deleted 
Process exit forced 
Process information gathered 
Process identifier granted 
Process resumed 
Process identifier revoked 
Process wakeup scheduled 
Process priority altered 
Process exception issued 
Process suspended 

Process termination notification requested 
Process wakeup issued 

Use of privilege 

Unsuccessful use of privilege 
Successful use of privilege 

Modification to the rights database 

Identifier added to rights database 
Rights database created 
Identifier granted to user 
List of identifier holders modified 
Identifier name or attributes modified 
Identifier removed from rights database 
Identifier taken away from user 

Use of the System Generation utility (SYSGEN) 

System Generation utility (SYSGEN) parameter modified 
Modification to system time 

System time set 
System time calibrated 

Modification to system user authorization file (SYSUAF) 

Record added to system user authorization file 
Record copied in system user authorization file 
Record deleted from system user authorization file 
Record modified in system user authorization file 
Record renamed in system user authorization file 


Table F-3 Description of Audit Event Flags 

Symbol 1 


Meaning 


NSA$M ACL 


Event generated by an alarm access control entry (ACE) or an audit 

Abij. 


1 A11 other flags are reserved by Digital. 


(continued on next page) 











Security Audit Message Format 
F.1 Audit Header Packet 



Event forced the audit server to write all buffered event messages to 
the audit log file. 



F.2 Audit Data Packets 

Figure F-3 illustrates the format of an audit data packet. NSA$K_PKT_HDR_ 
LENGTH defines the current size of each packet header (in bytes). 

Note that audit data packets do not appear in any predefined order within an 
event message, and packet types can appear more than once throughout the event 

message. 

For examples of the types of data appearing in different event messages, see the 
appendix of alarm messages in the Security Guide. 

Figure F-3 Audit Data Packet Format 


NSA$PACKET TYPE 


N S A$ W P AC KET S IZE 


NSA$R_PACKET_DATA, variable length information area 


ZK-0809A-GE 


Table F—4 describes the fields contained in these packets. 


Table F-4 

Description of the Audit Data Packet 

Field 

Symbolic Offset 

Contents 

Packet size 

Packet type 

Packet data 

NSA$W_PACKET_SIZE 

NSA$W_PACKET_TYPE 

NSA$R PACKET DATA 

Indicates the size of the data packet. (Word) 

Indicates the type of data in the packet, as described 
in Table F-5. 

Variable length field containing the packet data. 

Table F-5 describes the types of data in audit packets. 
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Security Audit Message Format 
F.2 Audit Data Packets 


: Packets 



NSA$_ACCESS_MODE 

NSA$_ACCOUNT 

NSA$_ALARM_NAME 

NSA$_ASSOCIATION_NAME 

NSA$_AUDIT_FLAGS 

NSA$_AUDIT_NAME 

NSA$_COMMAND_LINE 

NSA$_CONNECTION_ID 

NSA$_DECNET_LINK_ID 

NSA$_DECNET_OBJECT_NAME 

NSA$_DECNET_OBJECT_NUMBER 

NSA$_DEFAULT_USERNAME 

NSA$_DEVICE_NAME 

NSA$_DIRECTORY_ENTRY 

NSA$_DIRECTORY_ID 

NSA$_DIRECTORY_NAME 

NSA$_DISMOUNT_FLAGS 

NSA$_EFC_NAME 

NSA$_EVENT_FACILITY 

NSA$_FIELD_NAME 

N S A$_FILE_ID 
NSA$_FINAL_STATUS 

NSA$_HOLDER_NAME 

NSA$_HOLDER_OWNER 

NSA$_ID_ATTRIBUTES 


wSMxftgzsr* to the ° bj9ct “ <tefin * d 

Access mode of the process (Byte) 

characters) 1116 aSSOciated with the process (String of 1-32 

Name of the user (or the security class operators 
terminal) to receive the record (String of 1-32 characters) 

Interprocess communication (IPC) association name 
(String of 1-256 characters) 

Bit mask of enabled or disabled events. This is reserved 
to Digital and supported through VMS V5.5. (40-bvte 
record) (String of 1-65 characters) 

Journal file to receive the audit record (String of 1-65 
characters) 

Command line the user entered (String of 1-2048 
characters) 

Interprocess communication (IPC) connection 
identification (Longword) 

DECnet logical link identification (Longword) 

DECnet object name (String of 1-16 characters) 

DECnet object number (Longword) 

Default local user name for incoming network proxv 
requests (String of 1-32 characters) 

Device name where the volume resides (String of 1-64 
cnaracters ) 

Directory entry associated with file system operation 
(Longword) 

Directory file identification (Array of 3 words) 

Directory file name 

The $DMTDEF macro in STARLET defines the dismount 
nags; each flag is one quad word. 

Event flag cluster name (String of 1-16 characters) 

Facility code for the generated event (Word) 

Name of the field being modified. This is used in 
"t'S" with NSA$_ORIGINAL_DATA and NSA$_ 
NEW_DATA. (String of 1-256 characters) 

File identification (Array of words) 

Status (successful or unsuccessful) causing the auditing 
facility to be invoked (Longword) 

Name of user holding the identifier (String of 1-32 
characters) 

Owner (UIC) of holder (Longword) 

the identifier > which are defined by the 
$KGBDEF macro in STARLET (Longword) 

(continued on next page) 
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NSA$_ID_NAME 

NSA$_ID_NEW_ATTRIBUTES 

NSA$_ID_NEW_NAME 
N S A$_ID_NE W_VALUE 
NSA$_ID_VALUE 
NSA$_ID_VALUE_ASCII 
NSA$_IMAGE_NAME 

NSA$_INSTALL_FILE 

NSA$_INSTALL_FLAGS 


Name of the identifier (String of 1-32 characters) 

New attributes of the identifier, which are defined by the 
$KGBDEF macro in STARLET (Longword) 

New name of the identifier (String of 1-32 characters) 

New value of the identifier (Longword) 

Value of the identifier (Longword) 

Identification value provided by $IDTOASC (Longword) 


Name of the image being executed when the event took 
place (String of 1-1024 characters) 

The name of the installed file (String of 1-255 characters) 


The INSTALL flags correspond to qualifiers for the 
inSalV utility (for example* NSA$M_INS_EXECUTE_ 
ONT.Y'l: each flag is one longword. 


NSA$_LNM_PARENT_NAME 

NSA$_LNM_TABLE_NAME 


Name of the parent logical name table (String of 1-31 
characters) 

Name of the logical name table (String of 1-31 
characters) 


NSA$_LOCAL_USERNAME 

NSA$_LOGICAL_NAME 


User name of the account available for incoming network 
proxy requests (String of 1-32 characters) 

Logical name associated with the device (String of 1-255 
characters) 


NSA$_MAILBOX_UNIT 

NSA$_MATCHING_ACE 

NSA$_MESSAGE 

NSA$_MOUNT_FLAGS 

NSA$_MSGFILNAM 

NSA$_NEW_DATA 


NSA$_NEW_IMAGE_NAME 
N SA$_NE W_OWNER 
N S A$_NE W_PRIORITY 
NSA$_NEW_PRIVILEGES 
NSA$_NEW_PROCESS_ID 
N S A$_NE W_PROCE SS_N AME 
NSA$_NEW_PROCESS_OWNER 


Mailbox unit number (Longword) 

ACE granting or denying access (Array of bytes) 

Associated message code; see NSA$_MSGFILNAM for 
translation (Longword) 

The MOUNT flags defined by the $MNTDEF macro in 
STARLET (Longword) 


Message file containing the translation for the message 
code in NSA$_MESSAGE (String of 1-255 characters) 

Contents of the field named in NSA$_FIELD_NAME 
after the event occurred. NSA$_ORIGINAL_DATA 


1-n characters) 

Name of the new image (String of 1-1024 characters) 

New process owner (UIC) (Longword) 

New process priority (Longword) 

New privileges (Quadword) 

New identification of the process (Longword) 

New name of the process (String of 1-15 characters) 

New owner (UIC) of the process (Longword) 

(continued on next page) 
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Security Audit Message Format 
F.2 Audit Data Packets 


Table F -5 (Cont.) Types of Data 
Symbol 


in Audit Packets 



NSA$_NEW_USERNAME 
NSA$_NOP 

NSA$_OBJECT_CLASS 

nsa$_object_max_class 

N SA$_OB JE CT_MIN_CLASS 

NSA$_OBJECT_NAME 

NSA$_OBJECT_NAME_2 

NSA$_OBJECT_OWNER 

NSA$_OBJECT_PROTECTION 

NSA$_OBJECT_TYPE 

NSA$_OLD_PRIORITY 

nsa$_old_privileges 

NSA$_ORIGINAL_DATA 

N SA$_PARAMS_INU SE 
NSA$_PARAMS_ WRITE 
NSA$_PARENT_ID 

NSA$_PARENT_NAME 

NSA$_PARENT_OWNER 

NSA$_PARENT_USERNAME 

NSA$_PASSWORD 

nsa$_privileges 

NSA$_PRIVS_MISSING 

NSA$_PRIVS_USED 

NSA$_PROCESS_ID 


New user name (String of 1-32 characters) 

Packet in static event list to omit from proces sing 

Object class name, as defined by the system or by the 
user. (String of 1-23 characters) 

recor™) nimUm aCCCSS c ^ assi fi cation of the object. (20-byte 
The minimum access classification of the object. (20-byte 

icLUI U / 

Object’s name (String of 1-255 characters) 

Alternate object name; currently applies to file-backed 
global sections where the alternate name of global 
section is the file name. (String of 1-255 characters) 

IHC or general identifier of the process causing the 
auditable event (Longword) 

UIC-based protection of the object (Vector of words or 
longwords) 

Object’s type code, as listed in $ACLDEF This is 
supported through VMS V5.5. (String of 1-23 characters) 

Former process priority (Longword) 

Former privileges (Quadword) 

Contents of the field named in NSA$_FIELD_NAME 
before the event occurred. NSA$_NEW_DATA contains 
the field contents following the event. (String of 1-n 
characters) 

^°/lf rame i er values given t0 the SYSGEN command 
USE (String of 1-255 characters) 

File name for the SYSGEN command WRITE (String of 
1-255 characters) 

Process identification (PID) of the parent process; only 
used when auditing events pertaining to a subprocess 
(Longword) 

Parent s process name; only used when auditing events 
pertaining to a subprocess (String of 1-15 characters) 

Owner (UIC) of the parent process (Longword) 

User name associated with the parent process (String of 
1-32 characters) 

Password used in unsuccessful break-in attempt (String 
of 1-32 characters) 

Privilege mask (Quadword) 

Privileges that are lacking (Longword or quadword) 

Privileges used to gain access to the object (Longword or 
quadword) 

PID of the process causing the auditable event 
(Longword) 

(continued on next page) 
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Security Audit Message Format 
F.2 Audit Data Packets 



NSA$_REM_ASSOCIATION_NAME 

nsa$_remote_link_id 

NSA$_REMOTE_NODE_ID 

nsa$_remote_nodename 


Interprocess communication (IPC) remote association 
name (String of 1-256 characters) 

Remote logical link identification number (Longword) 
DECnet address of the remote process (Longword) 
DECnet node name of the remote process (String of 1-6 
characters) 


NSA$_REMOTE_USERNAME 

NSA$_REQUEST_NUMBER 

NSA$_RESOURCE_NAME 

NSA$_SECTION_NAME 

NSA$_SNAPSHOT_BOOTFILE 

NSA$_SNAPSHOT_SAVE_FILNAM 

NSA$_SNAPSHOT_TIME 


User name of the remote process (String of 1-32 
characters) 

Request number associated with the system service call. 
(Longword) 

Lock resource name (String of 1-32 characters) 

Global section name (String of 1-42 characters) 

The name of the snapshot boot file, the saved system 
image file from which the system just booted. (String ot 
1-255 characters) 

The name of the snapshot save file, which is the original 
location of the snapshot file at the time that the system 
was saved. (String of 1-255 characters) 

The time the picture of the configuration was taken and 
saved in the snapshot boot file. (Quadword) 


NSA$_SOURCE_PROCESS_ID 

NSA$_SUBJECT_CLASS 


Identification of process originating the request 
(Longword) 

The current access class of the process causing the 
auditable event. (A 20-byte record) 


NSA$_SUBJECT_OWNER 

NSA$_SYSTEM_ID 

NSA$_SYSTEM_NAME 


Owner (UIC) of the process causing the event. 
(Longword) 

SCS identification of the cluster node where the event 
took place (SYSGEN parameter SCSSYSTEMID). 


System Communication Services (SCS) node name where 
the event took place (SYSGEN parameter SCSNODE) 
(String of 1-6 characters) 


NSA$_SYSTEM_SERVICE_NAME 


Name of the system service associated with the event. 
(String of 1-256 characters) 


NSA$_SYSTIM_NEW 

NSA$_SYSTIM_OLD 

NSA$_TARGET_DEVICE_NAME 

NSA$_TARGET_PROCESS_CLASS 

NSA$_TARGET_PROCESS_ID 

NSA$_TARGET_PROCESS_NAME 

NSA$_TARGET_PROCESS_OWNER 

NSA$_TARGET_USERNAME 


New system time (Quadword) 

Old system time (Quadword) 

Target device name (String of 1-64 characters) 

The target process classification. (A 20-byte vector) 
Target process identifier (PID) (Longword) 

Target process name (String of 1-64 characters) 

Target process owner (UIC) (Longword) 

Target user name (String of 1-32 characters) 

(continued on next page) 


F-10 














Security Audit Message Format 
F.2 Audit Data Packets 


Table F -5 (Cont.) Types of Data 
Symbol 

NSA$_TERMINAL 

NSA$_TIME_STAMP 
NSA$_TRANSPORT_NAME 


NSA$_UAF_ADD 

NSA$_UAF_COPY 

NSA$_UAF_DELETE 

NSA$_UAF_FIELDS 

NSA$_UAF_MODIFY 

NSA$_UAF_RENAME 

N SA$_UAF_SOURCE 

NSA$_USERNAME 

NSA$_VOLUME_NAME 

NSA$_VOLUME_SET_NAME 


in Audit Packets 

Packet Contents 

Nameofthe terminal to which the process was connected 
when the auditable event occurred (String of 1-256 
characters) 

The time that the event occurred (Quadword) 

Name of transport: interprocess communication (IPC) 
DECnet, or System Management Integrator (SMI), which 
handles requests from the SYSMAN utility (String of 
1-256 characters) 

Name of the authorization record being added (String of 
1-32 characters) 

Original and new names of the authorization record 
being copied (String of 1-32 characters) 

N /, m .f° f , the authoriza tion record being removed (String 
ot 1-32 characters) 

Fields being changed in an authorization record and 
their new values. This is supported through VMS V5 5 
and reserved to Digital. (Quadword bitmask) 

Name of the authorization record being modified (String 
ot 1-32 characters) 

N /™ 0f , the authorizat ion record being renamed (String 
of 1-32 characters) 

S0Urce record for an Authorize utility 
(AU 1HORIZE) copy operation (String of 1-32 characters) 

User name of process causing the auditable event (String 
of 1-32 characters) 

Volume name (String of 1-15 characters) 

Volume set name (String of 1-15 characters) 
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Valid Combinations of BACKUP Qualifiers 


The following figures show the qualifiers that can be used in BACKUP save 
restore, copy, compare and list operations. The figures also indicate valid ’ 
combinations of BACKUP qualifiers. 

• Figure G-l shows command qualifiers used in save operations. 

• Figure G-2 shows input file-selection qualifiers used in save operations. 

• Figure G-3 shows output save-set qualifiers used in save operations. 

Figure G-4 shows command qualifiers used in restore operations. 

Figure G—5 shows input save-set qualifiers used in restore operations. 
Figure G-6 shows output file qualifiers used in restore operations. 

• Figure G-7 shows command qualifiers used in copy operations. 

• Figure G—8 shows input file-selection qualifiers used in copy operations. 

• Figure G-9 shows output file qualifiers used in copy operations. 

Figure G-10 shows command qualifiers used in compare operations. 

Figure G-ll shows input file-selection qualifiers used in compare operations. 

• Figure G-12 shows input save-set qualifiers used in compare operations. 


G-1 







of BACKUP Qualifiers 




Figure G-1 


Command Qualifiers Used in Save Operations 


Command 
Q ualifiers _ 

/[NOIASSIST 1 

/BRIEF 2 

/DELETE 

/FAST 

/FULL 2 

/IGNORE 

/IMAGE 

/[NO]INITIALIZE 

/INTERCHANGE 

/JOURNAL 

/LIST 

/[NO]LOG 

/PHYSICAL 

/RECORD 

/VERIFY 

/VOLUME 

Input 

File-Selection 

Qualifiers 

/BACKUP 

/BEFORE 

/BY_OWNER 

/CONFIRM 

/CREATED 

/EXCLUDE 

/EXPIRED 

/MODIFIED 

/SINCE 


-/[NO]ASSIST 

/BRIEF 
/DELETE 
■/FAST 


/FULL 

— /IGNORE 
-/IMAGE 

-/[NO]INITIALIZE 

/INTERCHANGE 

-/JOURNAL 

-/LIST 

-/[NO]LOG 


/PHYSICAL 

-/RECORD 

|-/VERIFY 

|-/VOLUME 


- Y 

Y - 

Y 

Y 

Y 

Y 

Y 
N 
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Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 
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Y 

Y 

Y 

Y 

Y 
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Y 

Y 

Y 

Y 

Y 

Y 

Y N 

N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y N 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y Y 

Y 

Y 

Y 

Y 

_ 

Y 

Y 

Y 

Y 

Y N 

Y 

Y 

Y 

Y 

Y 

- 

Y 

Y 

Y 

Y N 

Y 

Y 

Y 

Y 

Y 

Y 

- 

Y 

Y 

Y N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 
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Y 

Y N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


,y 3 n 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

3 - N 

Y 

Y 

Y 

Y 

N 

N 

N 

N 

N 

N - 

N 

Y 

N 

Y 

Y 

Y 

Y 

Y 

Y 

Y N 

- 

Y 

N 

Y 

Y 

Y 

Y 

Y 

Y 

Y Y 

Y 

— 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y N 

Y 

Y 

— 


yyyyyyny 
yyyyyyny 
yyy yyyny 
yyyyyyny 
yyyyyyny 
yyy yyyny 
yyy yyyny 
yyyyyyny 
yyyyyyny 


yyyynyyn 

yyyynyyn 

yyyynyyn 

yyyynyyn 

yyyynyyn 

yyyynyyn 

yyyynyyn 

yyyynyyn 

yyyynyyn 


Output 
File Qualifiers 


/BLOCK_SIZE 

/BY_OWNER 

/COMMENT 

/[NO]CRC 

/DENSITY 1 ’ 6 

/GROUP_SIZE 

/LABEL 1 

/PROTECTION 

/[NOIREWIND 1 

/SAVE_SET 5 

/TAPE_EXPIRATION 


YYY Y Y Y Y 
YYY Y Y Y Y 
YYY Y Y Y Y 

yyy y y y y 
yyy y y y y 
yyy y y y y 
yyy y y y y 
yyy y y y y 
yyy y y y y 

Y Y Y Y Y Y Y 
YYY Y Y Y Y 


yyyyyyyyy 

yyyyynyyy 

yyyyyyyyy 

yyyyyyyyy 

nyyyyyyyy 

yyyyyyyyy 

nyyyyyyyy 

yyyyyyyyy 

nyyyyyyyy 

yyyyyyyyy 

nyyyyyyyy 


1 Use only when saving to magnetic tape save sets. 

2 You must specify the /LIST qualifier with this qualifier. 

3 When you specify /LIST with /LOG, direct the output from the list operation to a file. 

4 You must specify /IMAGE with this qualifier. 

5 Required when creating save sets on disk. 

6 You must specify /REWIND with this qualifier. 
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Valid Combinations of BACKUP Qualifiers 


Figure G-2 Input File-Selection Qualifiers Used in Save Operations 


Input 

File-Selection 

Qualifiers 


/BACKUP 
— /BEFORE 

I-/BY_OWNER 

/CONFIRM 
— /CREATED 

/EXCLUDE 

-/EXPIRED 

|-/MODIFIED 

j— /SINCE 


/BACKUP 

- Y Y Y N Y 

N N Y 

/BEFORE 

Y - Y Y Y Y 

Y Y N 

/BY_OWNER 

Y Y - Y Y Y 

Y Y Y 

/CONFIRM 

Y Y Y - Y Y 

Y Y Y 

/CREATED 

N Y Y Y - Y 

N N Y 

/EXCLUDE 

Y Y Y Y Y - 

Y Y Y 

/EXPIRED 

N Y Y Y N Y 

-NY 

/MODIFIED 

N Y Y Y N Y 

N Y Y 

/SINCE 

Y N Y Y Y Y 

Y Y - 

Output 



Save-Set 



Qualifiers 



/BLOCK_SIZE 

Y Y Y Y Y Y 

Y Y Y 

/BY_OWNER 

Y Y Y Y Y Y 

Y Y Y 

/COMMENT 

Y Y Y Y Y Y 

Y Y Y 

/[NOJCRC 

Y Y Y Y Y Y 

Y Y Y 

/DENSITY 1 ’ 2 

Y Y Y Y Y Y 

Y Y Y 

/GROUP SIZE 

Y Y Y Y Y Y 

Y Y Y 

/LABEL 1 

Y Y Y Y Y Y 

Y Y Y 

/PROTECTION 

Y Y Y Y Y Y 

Y Y Y 

/[NOJREWIND 1 

Y Y Y Y Y Y 

Y Y Y 

/SAVE SET 3 

Y Y Y Y Y Y 

Y Y Y 

/tape_expiration 1 

Y Y Y Y Y Y 

Y Y Y 

1 Use only when saving to magnetic tape save sets. 

You must specify /REWIND with this qualifier. 


3 Required when creating save sets on disk. 
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Valid Combinations of BACKUP Qualifiers 


Figure G-3 Output Save-Set Qualifiers Used in Save Operations 


Input 

File-Selection 

Qualifiers 

/BACKUP 

/BEFORE 

/BY_OWNER 

/CONFIRM 

/CREATED 

/EXCLUDE 

/EXPIRED 

/MODIFIED 

/SINCE 


/BLOCK_SIZE 
— /BY_OWNER 

/COMMENT 
— /[NO]CRC 

/DENSITY 
— /GROUP_SIZE 
/LABEL 

-/MEDIA_FORMAT=[NO]COMPACTION 

,-/PROTECTION 

/[NO]REWIND 

-/SAVE_SET 

|-/TAPE_EXPIRATION 


Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 


Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 


Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 

Y Y Y Y 


Output 

Save-Set 

Qualifiers 


/BLOCK_SIZE 
/BY_OWNER 
/COMMENT 
/[NO]CRC 
/DENSITY 1 ’ * 

/GROUP_SIZE 

/label! , 

/MEDIA_FORMAT=[NO]COMPACTION 

/PROTECTION 

/[NOJREWIND 1 

/SAVE_SET 3 

/TAPE EXPIRATION 1 


-YYYYY YYYYYY 
Y-yYYY YYYYYY 
YY-YYY YYYYYY 

yyy-yyyyyyyy 
yyyy-yyyyyyy 
YYYYY - YYYYYY 
yyyyyy-yyyyy 
yyyyyyy-yyyy 
YYYYYY YY - YYY 
Y Y Y Y Y 2 Y Y Y Y - Y Y 
YYYYYY YYYY - Y 
YYYYYY YYYYY- 


1 Use only when saving to magnetic tape save sets. 

2 You must specify /REWIND with this qualifier. 

3 Required when creating save sets on disk. 
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Valid Combinations of BACKUP Qualifiers 


Figure G-4 Command Qualifiers Used in Restore Operations 


Command 

Qualifiers 


-/[NOJASSIST 

/BRIEF 
—/FULL 
— /IMAGE 


-/INCREMENTAL 

|-/[NOJINITIALIZE 

/LIST 

I-/[NOJLOG 

/PHYSICAL 

|-/[NOJTRUNCATE 

A/ERIFY 
/VOLUME 


/[NOJASSIST 1 

/BRIEF 2 

/FULL 2 

/IMAGE 

/INCREMENTAL 

/[NOJINITIALIZE 

/LIST 

/[NOJLOG 

/PHYSICAL 

/[NOJTRUNCATE 

/VERIFY 

A/OLUME 4 

- yyyynyyyyyy 

Y - NYYYYYNYYY 

Y n-yyyyynyyy 
v yy-nyyynyyy 

Y YYN-NYYNYYY 
N YYYN-YYNYYY 

Y YYYYY - Y 3 N Y Y Y 

Y YYYYY Y 3 Y N Y Y Y 

Y NNNNNNN-NYN 

Y YYYYYYY N-YY 

Y YYYYYYY YY-Y 

Y YYYNYYY N Y Y - 

Input 

Save-Set 

Qualifiers 

/[NOJCRC 

/LABEL 1 
/[NOJREWIND 1 
/SAVE SET 5 
/SELECT 

Y YYYYYYYNYYY 

Y YYYYNYYYYYY 

v yyyynyyyyyy 

Y YYYYYY YYYYY 

Y yynynyynyyn 

Output 

File Qualifiers 

/BY OWNER 

/NEW_VERSION 

/OVERLAY 

/REPLACE 

Y YYYYYYYNYYY 

Y yynyyyynyny 

Y YYNYYYYNYYY 

Y YYNYYYYNYYY 

Use only when restoring from magnetic tape save sets. 

You must specify the /LIST qualifier with this qualifier 

When you specify /LIST with /LOG, direct the output from the list 
operation to a file. 

4 You must specify /IMAGE with this qualifier. 

5 Required when restoring save sets from disk. 


J7 
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Valid Combinations of BACKUP Qualifiers 


Figure G-5 Input Save-Set Qualifiers Used in Restore Operations 


Input Save-Set 
Qu alifiers _ 

/[NO]CRC 
/[NOIREWIND * 1 
/SAVE_SET 2 
/SELECT 


/[NO]CRC 

Y 

Y 

Y 


/[NO]REWIND /SAVE_SET 

Y Y 

Y 

Y 

Y Y 


/SELECT 

Y 

Y 

Y 


Output File 
Qualifiers 

/BY_OWNER Y 

/NEW_VERSION Y 
/OVERLAY Y 

/REPLACE Y 


1 Use only when restoring from magnetic tape save sets. 

2 Required when restoring save sets from disk. 


Y 

Y 

Y 

Y 


ZK-0833A-GE 


Figure G-6 Output File Qualifiers Used in Restore Operations 


Input Save-Set 
Qualifiers 

/[NO]CRC 
/[NOJREWIND 1 
/SAVE_SET 2 
/SELECT 


/BY OWNER /NEW VERSION /OVERLAY 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 


Output File 

Qualifiers_ 

/BY_OWNER " Y 

/NEW_VERSION Y 
/OVERLAY Y N 

/REPLACE Y _N_ 

1 Use only when restoring from magnetic tape save sets. 

2 Required when restoring save sets from disk. 


/REPLACE 

Y 

Y 

Y 

Y 


Y 

N 

N 
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Valid Combinations of BACKUP Qualifiers 


Figure G-7 Command Qualifiers Used in Copy Operations 


Command 

Qualifiers 

/BRIEF 1 

/DELETE 

/FAST 

/FULL 1 

/IGNORE 

/IMAGE 

/[NOJINITIALIZE 

/LIST 

/[NOJLOG 

/PHYSICAL 

/RECORD 

/[NOJTRUNCATE 

/VERIFY 

A/OLUME 3 

Input 

File-Selection 

Qualifiers 


/BRIEF 

-/DELETE 

/FAST 

— /FULL 

/IGNORE 
— /IMAGE 


-/[NOJINITIALIZE 

/LIST 

I-/[NOJLOG 

/PHYSICAL 
— /RECORD 


- 

Y 

Y 

N 

Y 

Y 

Y 

Y 

Y 

N 

Y 

Y 

— 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

N 

N 

Y 

Y 

— 

Y 

Y 

Y 

Y 

Y 

Y 

N 

Y 

N 

Y 

Y 

- 

Y 

Y 

Y 

Y 

Y 

N 

Y 

Y 

Y 

Y 

Y 

- 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

- 

Y 

Y 

Y 

N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

- 

Y 

Y 

N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

- 

Y 2 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 2 

- 

N 

Y 

N 

N 

N 

N 

Y 

N 

N 

N 

N 

— 

N 

Y 

N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

N 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

N 

Y 


■ /[NOJTRUNCATE 
■ /VERIFY 
■ A/OLUME 


I-/VEI 

J_T' 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 
N 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 
N 

Y 

Y 

Y 


Y - 


/BACKUP 

/BEFORE 

/BY_OWNER 

/CONFIRM 

/CREATED 

/EXCLUDE 

/EXPIRED 

/MODIFIED 

/SINCE 

Output 

File Qualifiers 


Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 


Y Y N 

Y Y N 

Y Y N 

Y Y N 

Y Y N 

Y Y N 

Y Y N 

Y Y N 

Y Y N 


Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 


N Y Y 
N Y Y 
N Y Y 
N Y Y 
N Y Y 
N Y Y 
N Y Y 
N Y Y 
N Y Y 


Y N 

Y N 

Y N 

Y N 

Y N 

Y N 

Y N 

Y N 

Y N 


/BY OWNER 

/NEW_VERSION 

/OVERLAY 

/REPLACE 


yyyyynyyyny 

yyyyynyyyny 

yyyyynyyyny 

yyyyynyyyny 


Y Y N 

Y N N 

Y Y N 

Y Y N 


1 You must specify the /LIST qualifier with this qualifier 

to a 6 file y ° U SPeCify /UST Wi * h /LOG ’ dir6Ct the ° UtpUt fr ° m the list operation 
You must specify /IMAGE with this qualifier. 
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Valid Combinations of BACKUP Qualifiers 


Figure G-8 Input File-Selection Qualifiers Used in Copy Operations 


Input 

File-Selection 


/BACKUP 
— /BEFORE 

/BY_OWNER 
— /CONFIRM 

/CREATED 
— /EXCLUDE 
- /EXPIRED 


/BACKUP 

_ 

Y 

Y 

Y 

N 

Y 

N 

N 

Y 

/BEFORE 

Y 

— 

Y 

Y 

Y 

Y 

Y 

Y 

N 

/BY_OWNER 

Y 

Y 

— 

Y 

Y 

Y 

Y 

Y 

Y 

/CONFIRM 

Y 

Y 

Y 

- 

Y 

Y 

Y 

Y 

Y 

/CREATED 

N 

Y 

Y 

Y 

— 

Y 

N 

N 

Y 

/EXCLUDE 

Y 

Y 

Y 

Y 

Y 

— 

Y 

Y 

Y 

/EXPIRED 

N 

Y 

Y 

Y 

N 

Y 

— 

N 

Y 

/MODIFIED 

N 

Y 

Y 

Y 

N 

Y 

N 

” 

Y 

/SINCE 

Y 

N 

Y 

Y 

Y 

Y 

Y 

Y 


Output 










File Qualifiers 










/BY_OWNER 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

/NEW_VERSION 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

/OVERLAY 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

/REPLACE 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


" /MODIFIED 
j— /SINCE 
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Valid Combinations of BACKUP Qualifiers 


Figure G-9 Output File Qualifiers Used in Copy Operations 


Input File-Selection 

Qualifiers /BY OWNER /NEW VERSION 


/OVERLAY /REPLACE 


/BACKUP 

/BEFORE 

/BY_OWNER 

/CONFIRM 

/CREATED 

/EXCLUDE 

/EXPIRED 

/MODIFIED 

/SINCE 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Output File 

Qualifiers 


/BY OWNER 

/NEW_VERSION Y 

/OVERLAY y 

/REPLACE y 


Y 

N 

N 


Y 

N 

N 


Y 

N 

N 
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Valid Combinations of BACKUP Qualifiers 


Figure G-10 Command Qualifiers Used in Compare Operations 


Command 

Qualifiers 


,-/[NO]ASSIST 

I-/BRIEF 

.-/COMPARE 

I-/FAST 

I-/FULL 

i-/IMAGE 

i-/LIST 

,-/[NO]LOG 

.-/PHYSICAL 

I-/VOLUME 

MIL 


/[NO]ASSIST 1 

/BRIEF 2 

/COMPARE 

/FAST 

/FULL 2 

/IMAGE 

/LIST 

/[NO]LOG 

/PHYSICAL 

A/OLUME 4 


-YYYY YYYYY 
y-yynyyyyy 
YY-YY YYYYY 
YYY-Y YYYYY 
YNYY - YYYYY 
yyyyy-yyny 
YYYYY Y - Y 3 Y Y 
YYYYY Y Y - Y Y 

YYYYY NYY-Y 
YYYYY YYYN- 


Input 

File-Selection 

Qualifiers 


/BY_OWNER 

/BEFORE 

/EXCLUDE 

/SINCE 


YYYYY NYYNN 
YYYYY NYYNN 
YYYYY NYYNN 
YYYYY NYYNN 


1 Use only when comparing magnetic tape save sets. 

2 You must specify the /LIST qualifier with this qualifier. 

2 When you specify /LIST with /LOG, direct the output from the 
list operation to a file. 

4 You must specify /IMAGE with this qualifier. 
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Valid Combinations of BACKUP Qualifiers 


Figure G-11 Input File-Selection Qualifiers Used in Compare Operations 

Input File-Selection 
Qualifiers 

/BY OWNER 

/before 

/EXCLUDE 

/SINCE 

/BY OWNER 

- 

Y 

Y 

v 

/before 

Y 


Y 

T 

N 

Y/ 

/EXCLUDE 

Y 

Y 


/SINCE 

Y 

N 

Y 

Y 

Input Save-Set 

Qualifiers 

/[NOJREWIND 1 

Y 

Y 

Y 

V 

/SAVE_SET 2 

Y 

Y 

Y 

T 

Y 

/SELECT 

Y 

Y 

Y 

i 

Y 

1 Use only when comparing magnetic tape save sets. 

2 Required when comparing save sets on disk. 
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Figure G-12 Input Save-Set Qualifiers Used in Compare Operations 


Input File-Selection 


Qualifiers _ /[NOJREWIND /SAVE_SET /SELECT 


/BY OWNER 

Y 

Y 

Y 

/BEFORE 

Y 

Y 

Y 

/EXCLUDE 

Y 

Y 

Y 

/SINCE 

Y 

Y 

Y 

Input Save-Set 

Qualifiers 

/[NOJREWIND 1 

— 

Y 

Y 

/SAVE_SET 2 

Y 


Y 

/SELECT 

Y 

Y 

I 

1 Use only when comparing magnetic tape save sets. 

2 Required when comparing save sets on disk. 
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Access control 

required by ACL editor, Sys Mgmt Util A-L 
1-4 

with Identifier ACEs, Sys Mgmt Util A-L, 1-13 
with protection codes, Sys Mgmt Util A-L, 1-12 
Access control entries 
See ACEs 

Access control list editor 
See ACL editor 
Access control lists 
See ACLs 

/ACCESSED qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-8 
Accounting 

enabling image-level accounting, Sys Mgmt 
Util A-L, 11-5, 11-8, 11-19 
ACCOUNTING command, Sys Mgmt Util A-L 
2-4 

Accounting files 

copying records between, Sys Mgmt Util A-L 
2-8, 2-19 

processing to produce reports, Sys Mgmt Util 
A-L, 2-9, 2-11, 2-25 

record format of, Sys Mgmt Util A-L, C-l 
types of record in, Sys Mgmt Util A-L, 2-29 
Accounting reports 

brief reports, Sys Mgmt Util A-L, 2-9 
full reports, Sys Mgmt Util A-L, 2-11 
summary reports, Sys Mgmt Util A-L, 2-25 
Accounting utility (ACCOUNTING), Sys Mgmt 
Util A-L , 2-4 

ACEs (access control entries), Sys Mgmt Util A-L 
1-3, 1-6 

application-specific, Sys Mgmt Util A-L, 1-6 
Creator ACEs, Sys Mgmt Util A-L, 1-9 
Default Protection ACEs, Sys Mgmt Util A-L 
1-11 

Identifier ACEs, Sys Mgmt Util A-L, 1-13 
ordering entries in an ACL, Sys Mgmt Util 
A-L, 1-3 

relationship to ACLs, Sys Mgmt Util A-L, 1-3 
security Alarm, Sys Mgmt Util A-L, 1-6 
security Audit, Sys Mgmt Util A-L, 1-8 
Subsystem ACEs, Sys Mgmt Util A-L, 1-15 


ACL editor, Sys Mgmt Util A-L, 1-3 

/CLASS qualifier, Sys Mgmt Util A-L, 1-17 
control access to objects, Sys Mgmt Util A-L, 
1-4 

customizing, Sys Mgmt Util A-L, B-l 
DCL qualifiers, Sys Mgmt Util A-L, 1-17 to 
1-19 

exiting from, Sys Mgmt Util A-L, 1-5 
file format required, Sys Mgmt Util A-L, 1-4 
how to use, Sys Mgmt Util A-L, 1-3 
invoking, Sys Mgmt Util A-L, 1-4 
/JOURNAL qualifier, Sys Mgmt Util A-L, 1-18 
keypad editing, Sys Mgmt Util A-L, A-l 
/MODE qualifier, Sys Mgmt Util A-L, 1-19 
object ownership, Sys Mgmt Util A-L, 1-4 
/OBJECT.TYPE qualifier, Sys Mgmt Util A-L 
1-19 


privileges required, Sys Mgmt Util A-L, 1-4 
prompting by, Sys Mgmt Util A-L, A-l ’ 
/RECOVER qualifier, Sys Mgmt Util A-L, 1-19 
specifying file type, Sys Mgmt Util A-L, 1-4 
specifying object class, Sys Mgmt Util A-L 1-5 
1-17 

wildcard restriction, Sys Mgmt Util A-L, 1-4 
ACLs (access control lists) 

impact of length on performance, Sys Mgmt 
Util A-L, 1-3 

list of supported object classes, Sys Mgmt Util 
A-L, 1-3 

relationship to ACEs, Sys Mgmt Util A-L, 1-3 
rules for ordering entries, Sys Mgmt Util A-L 
1-3 

ACL section files, Sys Mgmt Util A-L, B-l 
ACP (ancillary control process) 

volume mount, Sys Mgmt Util M-Z, 2-30 
ACP system parameters 

See also System parameters 
ACP_BASEPRIO, Sys Mgmt Util M-Z, C-6 
ACP_DATACHECK, Sys Mgmt Util M-Z, C-6 
ACP_DINDXCACHE, Sys Mgmt Util M-Z, C—7 
ACP_DIRCACHE, Sys Mgmt Util M-Z, C-7 
ACP_EXTCACHE, Sys Mgmt Util M-Z, C-7 
ACP_EXTLIMIT, Sys Mgmt Util M-Z, C-7 
ACP_FIDCACHE, Sys Mgmt Util M-Z, C-7 
ACP_HDRCACHE, Sys Mgmt Util M-Z, C-7 
ACP_MAPCACHE, Sys Mgmt Util M-Z, C-7 
ACP_MAXREAD, Sys Mgmt Util M-Z, C-7 
ACP_MULTIPLE, Sys Mgmt Util M-Z, C-7 
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ACP system parameters (cont’d) 

ACP_QUOCACHE, Sys Mgmt Util M-Z, C-8 
ACP_REBLDSYSD, Sys Mgmt Util M-Z, C-8 
ACP_SHARE, Sys Mgmt Util M-Z, C-8 
ACP_SWAPFLGS, Sys Mgmt Util M-Z, C-8 
ACPJ3YSACC, Sys Mgmt Util M-Z, C-8 
ACP_WINDOW, Sys Mgmt Util M-Z, C-9 
ACP_WORKSET, Sys Mgmt Util M-Z, C-9 
ACP_WRITEBACK, Sys Mgmt Util M-Z, C-9 
ACP_XQP_RES, Sys Mgmt Util M-Z, C-9 
Actual node name, Sys Mgmt Util A-L, 13—55 
Actual port name, Sys Mgmt Util A-L, 13—55 
Actual service name, Sys Mgmt Util A-L, 13—55 

Adapters 

See Bus adapters 
ADD (Field) command 

CIRCUITS class, Sys Mgmt Util M-Z, 4-19 
CLUSTER class, Sys Mgmt Util M-Z, 4-20 
CONNECTIONS class, Sys Mgmt Util M-Z, 
4-21 

COUNTERS class, Sys Mgmt Util M-Z, 4-22 
CREDITS class, Sys Mgmt Util M-Z, 4-23 
ERRORS class, Sys Mgmt Util M-Z, 4-23 
in Show Cluster utility, Sys Mgmt Util M-Z, 
4-19 

LOCAL_PORTS class, Sys Mgmt Util M-Z, 
4-23 

MEMBERS class, Sys Mgmt Util M-Z, 4-25 
SYSTEMS class, Sys Mgmt Util M-Z, 4-27 
ADD CIRCUITS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-11 

ADD CLUSTER command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-13 

ADD command 

in Authorize utility, Sys Mgmt Util A-L, 5-8 
in Install utility, Sys Mgmt Util A-L, 11-5 
ADD CONNECTIONS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-14 

ADD COUNTERS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-15 

ADD CREDITS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-17 

ADD ERRORS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-18 

ADD/IDENTIFIER command 

in Authorize utility, Sys Mgmt Util A-L, 5-20 
ADD LOCAL_PORTS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-28 

ADD MEMBERS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-30 


ADD/PROXY command 

in Authorize utility, Sys Mgmt Util A-L, 5-22 
ADD SYSTEMS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-31 

AFFINITY_SKIP system parameter, Sys Mgmt 
Util M-Z, C-52 

AFFINITY_TIME system parameter, Sys Mgmt 
Util M-Z, C-52 ., . y 

AGEN$FEEDBACK.DAT file, Sys Mgmt Util A-L, 

6-5, 6-6 

AGEN$FEEDBACK.EXE file, Sys Mgmt Util A-L, 
6-5 

AGEN$PARAMS.REPORT file, Sys Mgmt Util 
A-L, 6-7 

Alarm ACEs, Sys Mgmt Util A-L, 1-6 
keywords, Sys Mgmt Util A-L, 1—7 
specifying access, Sys Mgmt Util A-L, 1—7 

Alarm messages 

See Security alarm messages 


ALF 

See Automatic login facility 
ALF ADD command 

in SYSMAN, Sys Mgmt Util M-Z, 6-10 
ALF REMOVE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-11 
ALF SHOW command 

in SYSMAN, Sys Mgmt Util M-Z, 6-13 
/ALIAS qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-14 
ALLOCLASS system parameter, Sys Mgmt Util 
M-Z, C-9 

ALPHAVMSSYS.OLD file, Sys Mgmt Util A-L, 

6-7 

ALPHAVMSSYS.PAR file, Sys Mgmt Util A-L, 6-7 
ANALYZE/AUDIT command 
See also Audit Analysis utility 
/BEFORE qualifier, Sys Mgmt Util A-L, 4-5 
/BINARY qualifier, Sys Mgmt Util A-L, 4-6 
/BRIEF qualifier, Sys Mgmt Util A-L, 4-7 
/EVENT_TYPE qualifier, Sys Mgmt Util A-L, 
4-7 

/FULL qualifier, Sys Mgmt Util A-L, 4-9 
/IGNORE qualifier, Sys Mgmt Util A-L, 4-9 
/INTERACTIVE qualifier, Sys Mgmt Util A-L, 
4-10 

/OUTPUT qualifier, Sys Mgmt Util A-L, 4-4, 
4-11 

/PAUSE qualifier, Sys Mgmt Util A-L, 4-12 
/SELECT qualifier, Sys Mgmt Util A-L, 4-12 
/SINCE qualifier, Sys Mgmt Util A-L, 4-22 
/SUMMARY qualifier, Sys Mgmt Util A-L, 4-23 
ANALYZE/DISKJ3TRUCTURE command, Sys 
Mgmt Util A-L, D—1 
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Analyze/Disk_Structure utility (ANALYZE/DISK 
STRUCTURE) 

directing output, Sys Mgmt Util A-L, 3-5, 3-6 
file recovery, Sys Mgmt Util A-L, 3-4 
invoking, Sys Mgmt Util A-L, 3-6 
parameter, Sys Mgmt Util A-L, 3-6 
qualifiers, Sys Mgmt Util A-L, 3-7 to 3-11 
/HOMEBLOCKS, Sys Mgmt Util A-L, 3-8 
/[NOJCONFIRM, Sys Mgmt Util A-L, 3-7 
/'INOILIST, Sys Mgmt Util A-L, 3-8 
/[NOJOUTPUT, Sys Mgmt Util A-L, 3-9 
/[NOJREAD_CHECK, Sys Mgmt Util A-L 
3-9 

/[NOJREPAIR, Sys Mgmt Util A-L, 3-11 
/RECORD_ATTRIBUTES, Sys Mgmt Util 
A-L, 3-10 

/USAGE, Sys Mgmt Util A-L, 3-11 
repairing disk errors, Sys Mgmt Util A-L, 3-3 
3-11 

reporting disk errors, Sys Mgmt Util A-L, 3-3 
requirements and limitations, Sys Mgmt Util 
A-L, 3—6 

ANALYZE/ERROR_LOG command, Sys Mgmt 
Util A-L, 10-4 

See also Error Log utility 
Application port, Sys Mgmt Util A-L, 13-10 
13-35, 13-37 

displaying, Sys Mgmt Util A-L, 13-52 
mapping, Sys Mgmt Util A-L, 13-37 
Application service, Sys Mgmt Util A-L, 13-10 
13-14, 13-36, 13-39 
defined, Sys Mgmt Util A-L, 13-16 
setting up, Sys Mgmt Util A-L, 13-36 
Arrow keys 

definition for, Sys Mgmt Util M-Z, 4-53 
functions of, Sys Mgmt Util M-Z, B-3 
/ASSIST qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-15 
in Mount utility, Sys Mgmt Util M-Z, 2-8 
Asterisk (*) 

wildcard character, Sys Mgmt Util A-L, 7-8 
Asynchronous device 

LAT application ports for, Sys Mgmt Util A-L 
13-10, 13-35 
ATTACH command 

in LATCP, Sys Mgmt Util A-L, 13-6 
in SYSMAN, Sys Mgmt Util M-Z, 6-13 
Attributes 

Dynamic, Sys Mgmt Util A-L, 5-21, 5-29, 5-37 
Holder Hidden, Sys Mgmt Util A-L, 5-21 
5-29, 5-37 

Name Hidden, Sys Mgmt Util A-L, 5-21, 5-29 
5-37 

No Access, Sys Mgmt Util A-L, 5-21, 5-29 
5-37 

Resource, Sys Mgmt Util A-L, 5-21, 5-29, 5-37 
specifying identifier characteristics, Sys Mgmt 
Util A-L, 1-16 


Attributes (cont’d) 

Subsystem, Sys Mgmt Util A-L, 5-21, 5-29 
5-37 

Audit ACEs, Sys Mgmt Util A-L, 1-8 

specifying access, Sys Mgmt Util A-L, 1-9 
specifying attributes, Sys Mgmt Util A-L, 1-8 
Audit Analysis utility (ANALYZE/AUDIT), Sys 
Mgmt Util A-L, 4-3 to 5-1 
CONTINUE command, Sys Mgmt Util A-L 
4-25 

default input file, Sys Mgmt Util A-L, 4-4 
directing output, Sys Mgmt Util A-L, 4-4 
DISPLAY command, Sys Mgmt Util A-L, 4-25 
displaying current selection criteria, Sys Memt 
Util A-L, 4-30 

EXIT command, Sys Mgmt Util A-L, 4-27 
exiting from, Sys Mgmt Util A-L, 4-4, 4-27 
HELP command, Sys Mgmt Util A-L, 4-27 
interactive commands, Sys Mgmt Util A-L 
4-10, 4-25 

invoking, Sys Mgmt Util A-L, 4-4 
LIST command, Sys Mgmt Util A-L, 4-28 
NEXT FILE command, Sys Mgmt Util A-L 
4-28 

NEXT RECORD command, Sys Mgmt Util A-L 
4-29 

POSITION command, Sys Mgmt Util A-L, 4-29 
qualifiers, Sys Mgmt Util A-L, 4-5 
selecting by access type, Sys Mgmt Util A-L 
4-13 

selecting by account name, Sys Mgmt Util A-L 
4-13 

selecting by device name, Sys Mgmt Util A-L 
4-13 

selecting by facility, Sys Mgmt Util A-L, 4-14 
selecting by identifier, Sys Mgmt Util A-L 
4-15 

selecting by identifier holder, Sys Mgmt Util 
A-L, 4-15 

selecting by image name, Sys Mgmt Util A-L 
4-15 

selecting by installation event, Sys Memt Util 
A-L, 4-16 

selecting by local proxy account, Sys Mgmt Util 
A-L , 4—16 

selecting by network attribute, Sys Mgmt Util 
A-L , 4—19 

selecting by object, Sys Mgmt Util A-L, 4-18 
selecting by parent process, Sys Mgmt Util 
A-L, 4-19 

selecting by privilege, Sys Mgmt Util A-L, 4-19 
selecting by process, Sys Mgmt Util A-L, 4-19 
selecting by success status, Sys Mgmt Util A-L 
4-20 

selecting by system characteristic, Sys Mgmt 
Util A-L , 4-20 

selecting by terminal name, Sys Mgmt Util 
A-L, 4-20 
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Audit Analysis utility (ANALYZE/AUDIT) (cont d) 
selecting by user name, Sys Mgmt Util A-L, 

4-21 

selecting by volume, Sys Mgmt Util A-L, 4-14, 
4—16, 4—17, 4—21 

SHOW command, Sys Mgmt Util A-L, 4-30 
Audit data packets 

See Security audit data packets 
Audit event flags 

See Security audit event flags 
Audit header packets 

See Security audit header packets 
Auditing security records 
See Audit Analysis utility 
Audit log files 

See Security audit log files 
Audit messages 

See Security audit event messages 
Audit reports 

See Security audit reports 
AUTHORIZE command 
See Authorize utility 
Authorize utility (AUTHORIZE) 

ADD command, Sys Mgmt Util A-L, 5-8 
ADD/IDENTIFIER command, Sys Mgmt Util 
A-L, 5-20 

ADD/PROXY command, Sys Mgmt Util A-L, 

5-22 

commands summary (table), Sys Mgmt Util 
A-L, 5-7 

controlling access with identifiers, Sys Mgmt 
Util A-L, 1-13 

COPY command, Sys Mgmt Util A-L, 5-24 
CREATE/PROXY command, Sys Mgmt Util 
A-L, 5-25 

CREATE/RIGHTS command, Sys Mgmt Util 
A-L, 5-26 

DEFAULT command, Sys Mgmt Util A-L, 5-27 
default password, Sys Mgmt Util A-L, 5-8 
DEFAULT record, Sys Mgmt Util A-L, 5-8 
EXIT command, Sys Mgmt Util A-L, 5-28 
exiting from, Sys Mgmt Util A-L, 5—5 
GRANT/IDENTIFIER command, Sys Mgmt 
Util A-L , 5—28 

HELP command, Sys Mgmt Util A-L, 5-30 
invoking, Sys Mgmt Util A-L, 5—5 
LIST command, Sys Mgmt Util A-L, 5-31 
LIST/IDENTIFIER command, Sys Mgmt Util 
A-L, 5-33 

LIST/PROXY command, Sys Mgmt Util A-L, 
5-34 

LIST/RIGHTS command, Sys Mgmt Util A-L, 
5-35 

login flags, Sys Mgmt Util A-L, 5—11 
MODIFY command, Sys Mgmt Util A-L, 5-36 


Authorize utility (AUTHORIZE) (cont’d) 

MODIFY/IDENTIFIER command, Sys Mgmt 
Util A-L, 5-37 

MODIFY/PROXY command, Sys Mgmt Util 
A-L, 5-39 

MODIFY/SYSTEM_PASSWORD command, Sys 
Mgmt Util A-L, 5—40 

privileges required, Sys Mgmt Util A-L, 5—3 
REMOVE command, Sys Mgmt Util A-L, 5-41 
REMOVE/IDENTIFIER command, Sys Mgmt 
Util A-L, 5—41 

REMOVE/PROXY command, Sys Mgmt Util 
A-L, 5-42 

RENAME command, Sys Mgmt Util A-L, 5-43 
RENAME/IDENTIFIER command, Sys Mgmt 
Util A-L, 5-45 

restrictions, Sys Mgmt Util A-L, 5—3 
REVOKE/IDENTIFIER command, Sys Mgmt 
Util A-L, 5-45 

SHOW command, Sys Mgmt Util A-L, 5-46 
SHOW/IDENTIFIER command, Sys Mgmt Util 
A-L, 5-50 

SHOW/PROXY command, Sys Mgmt Util A-L, 
5-52 

SHOW/RIGHTS command, Sys Mgmt Util A-L, 
5-54 

Autoconfiguration 

VAXstation 2000 (table), Sys Mgmt Util M-Z, 
D-7 

VAXstation 2000 and MicroVAX 2000 devices, 
Sys Mgmt Util M-Z, D—6 
AUTOCONFIGURE command 

in SYSGEN, Sys Mgmt Util M-Z, 5-5 
Autoconfiguring devices 

on Alpha systems, Sys Mgmt Util M-Z, 6-33 
AUTOGEN.COM command procedure, Sys Mgmt 
Util A-L, 6-3 

calculation of parameter values, Sys Mgmt Util 
A-L, 6-7 

collection of data, Sys Mgmt Util A-L, 6-6 
display of page, swap, and dump file size 
calculations, Sys Mgmt Util A-L, 6—7 
end phase 

default, Sys Mgmt Util A-L, 6—10 
specifying when invoking, Sys Mgmt Util 
A-L, 6-10 

examining calculations of, Sys Mgmt Util A-L, 

6-4 

execution mode 

specifying when invoking, Sys Mgmt Util 
A-L, 6-10 

feedback, Sys Mgmt Util A-L, 6-3, 6-4 
collection of, Sys Mgmt Util A-L, 6—5 
data file, Sys Mgmt Util A-L, 6-5 
parameters affected by, Sys Mgmt Util 
A-L, 6-5 

files used by, Sys Mgmt Util A-L, 6-9 
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AUTOGEN.COM command procedure (cont’d) 
generation of known image file list 

(VMSIMAGES.DAT), Sys Mgmt Util A-L 
6—7 

GENFILES phase, Sys Mgmt Util A-L, 6-7 
GENPARAMS phase, Sys Mgmt Util A-L, 6-7 
GETDATA phase, Sys Mgmt Util A-L, 6-6 
HELP phase, Sys Mgmt Util A-L, 6-8 
input files, Sys Mgmt Util A-L, 6-9 
invoking, Sys Mgmt Util A-L, 6-10 
operations performed by, Sys Mgmt Util A-L 
6-5 

output files, Sys Mgmt Util A-L, 6-9 
parameters to, Sys Mgmt Util A-L, 6-10 
phases, Sys Mgmt Util A-L, 6-5 

specifying when invoking, Sys Mgmt Util 
A-L, 6—10 

REBOOT phase, Sys Mgmt Util A-L, 6-8 
restriction with changing system files sizes, 

Sys Mgmt Util A-L, 6-7 
SAVPARAMS phase, Sys Mgmt Util A-L, 6-6 
SETPARAMS phase, Sys Mgmt Util A-L, 6-7 
SHUTDOWN phase, Sys Mgmt Util A-L, 6-8 
start phase 

default, Sys Mgmt Util A-L, 6-10 
specifying when invoking, Sys Mgmt Util 
A-L, 6-10 

system parameters affected by, Sys Mgmt Util 
A-L, 6—4 

system parameters affected by feedback, Sys 
Mgmt Util A-L, 6-5 

TESTFILES phase, Sys Mgmt Util A-L, 6-7 
when to run, Sys Mgmt Util A-L, 6-3 
AUTOGEN.PAR, Sys Mgmt Util A-L, 6-6, 6-7 
Automatic login facility (ALF) 

adding records, Sys Mgmt Util M-Z, 6-10 
displaying records, Sys Mgmt Util M-Z, 6-13 
removing records, Sys Mgmt Util M-Z, 6-11 
/AUTOMATIC qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-9 
AWSMIN system parameter, Sys Mgmt Util M-Z 
C-9 

AWSTIME system parameter, Sys Mgmt Util 
M-Z, C-10 

B 

Backlinks 

definition, Sys Mgmt Util A-L, 3-3 
Backup 

compare operation for, Sys Mgmt Util A-L 
7-23 
image 

See Image backup 
incremental 

See Incremental backup 
list operation, Sys Mgmt Util A-L, 7-18, 7-32 
7-44 


Backup (cont’d) 

selective, Sys Mgmt Util A-L, 7-16, 7-17 7-30 
7-31, 7-47 
standalone 

See Standalone BACKUP 
BACKUP command, Sys Mgmt Util A-L, 7-5 to 
7-69 

See also Backup utility 
element lists, Sys Mgmt Util A-L, 7-6 
format, Sys Mgmt Util A-L, 7-5 
input specifier, Sys Mgmt Util A-L, 7-5 
output specifier, Sys Mgmt Util A-L, 7-5 
specifying input, Sys Mgmt Util A-L, 7-5 
specifying output, Sys Mgmt Util A-L, 7-5 
specifying wildcard characters, Sys Mgmt Util 
A-L, 7-8 

types of qualifiers, Sys Mgmt Util A-L, 7-7 
using with save sets, Sys Mgmt Util A-L, 7-5 
/BACKUP qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-16 
Backups 

improving the speed of, Sys Mgmt Util A-L 
7-31 

Backup utility (BACKUP) 

command line qualifiers, Sys Mgmt Util A-L 
7-7 

command line syntax, Sys Mgmt Util A-L, 7-5 
/DELETE qualifier, Sys Mgmt Util A-L, 7-26 
directing output from, Sys Mgmt Util A-L, 7-11 
exiting from, Sys Mgmt Util A-L, 7-11 
invoking, Sys Mgmt Util A-L, 7-11 
using to compare files, Sys Mgmt Util A-L 
7-23 

BALSETCNT system parameter, Sys Mgmt Util 
M-Z, C-10 
Batch execution 

on remote nodes, Sys Mgmt Util M-Z, 6-6 
/BEFORE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-17 
/BEGINNING qualifier, Sys Mgmt Util M-Z, 4-6 
in Monitor utility, Sys Mgmt Util M-Z, 1-9 
Binary output from Audit Analysis utility, Sys 
Mgmt Util A-L, 4-6 
/BIND qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-10 
Block cache allocation, Sys Mgmt Util M-Z, 2-30 
Blocks 

erasing, Sys Mgmt Util A-L, 3-5 
/BLOCKSIZE qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-11 
/BLOCKJSIZE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-18 
Bootstrap operations, Sys Mgmt Util M-Z, 5-3 
BOOT_STYLE system parameter, Sys Mgmt Util 
M-Z, C-10 
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BORROWLIM system parameter, Sys Mgmt Util 
M-Z, C-10 

BREAKPOINTS system parameter, Sys Mgmt 
Util M-Z, C-52 

Brief format listings, Sys Mgmt Util A-L, 4-7 
/BRIEF qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-18 
Brief report 

example, Sys Mgmt Util A-L , 9—22 
/BUFFER_COUNT qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-19 
BUGCHECKFATAL system parameter, Sys Mgmt 
Util M-Z, C-ll 

BUGREBOOT system parameter, Sys Mgmt Util 
M-Z, C-ll 
Bus adapters 

generic names, Sys Mgmt Util M-Z , 5—23 
listing, Sys Mgmt Util M-Z , 5—23 
nexus numbers, Sys Mgmt Util M-Z , 5—23 
specifying, Sys Mgmt Util M-Z , 5—5, 5—9 
Buses 

display on Alpha systems, Sys Mgmt Util M-Z, 
6-39 

/BY_NODE qualifier 

in Monitor utility, Sys Mgmt Util M-Z, 1-9 
/BY_OWNER qualifier 

as Backup utility input file qualifier, Sys Mgmt 
Util A-L, 7-19 

as Backup utility output file qualifier, Sys 
Mgmt Util A-L, 7—20 

as Backup utility output save-set qualifier, Sys 
Mgmt Util A-L, 7-21 

c__ 

/CACHE qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-12 
Changing formats (of software kits), Sys Mgmt 
Util M-Z, 3-7 

Changing page, swap, and dump file sizes, Sys 
Mgmt Util A-L, 6—3 
Changing system parameters 

recommended method, Sys Mgmt Util A-L, 6—3 
CHANNELCNT system parameter, Sys Mgmt 
Util M-Z, C-52 

CHECK_CLUSTER system parameter, Sys Mgmt 
Util M-Z, C-ll 

CHECK_FEEDBACK mode, Sys Mgmt Util A-L, 
6-8 

CIRCUITS class 

adding, Sys Mgmt Util M-Z, 4-12 
fields belonging to, Sys Mgmt Util M-Z, 4-19 
removing, Sys Mgmt Util M-Z, 4—40 
Circuit timer, Sys Mgmt Util A-L, 13-27 
Classes 

SHOW CLUSTER, Sys Mgmt Util M-Z, 4-3 


Class-Name qualifier 
in Monitor utility 

/ALL, Sys Mgmt Util M-Z, 1-14 
/AVERAGE, Sys Mgmt Util M-Z, 1-14 
/CPU, Sys Mgmt Util M-Z, 1-34 
/CURRENT, Sys Mgmt Util M-Z, 1-14 
/ITEM, Sys Mgmt Util M-Z, 1-21, 1-47 
/MAXIMUM, Sys Mgmt Util M-Z, 1-14 
/MINIMUM, Sys Mgmt Util M-Z, 1-14 
/PERCENT, Sys Mgmt Util M-Z, 1-21 
/TOPBIO, Sys Mgmt Util M-Z, 1-40 
/TOPCPU, Sys Mgmt Util M-Z, 1-40 
/TOPDIO, Sys Mgmt Util M-Z, 1-40 
/TOPFAULT, Sys Mgmt Util M-Z, 1-40 
/TOPRBS, Sys Mgmt Util M-Z, 1-41 
CLASS_PROT system parameter, Sys Mgmt Util 
M-Z, C-ll 

CLEAR DEVICE command 

in LANCP utility, Sys Mgmt Util A-L, 12-8 
CLEAR MOPDLL command 

in LANCP utility, Sys Mgmt Util A-L, 12-9 
CLEAR NODE command 

in LANCP utility, Sys Mgmt Util A-L, 12-9 
CLISYMTBL system parameter, Sys Mgmt Util 
M-Z, C-ll 

CLOCKJNTERVAL system parameter, Sys Mgmt 
Util M-Z, C-52 
CLOSE LOG command 

in LMCP, Sys Mgmt Util A-L, 14-5 

CLUE 

See Crash Log Utility Extractor 
CLUSTER class 

adding, Sys Mgmt Util M-Z, 4-13 
fields belonging to, Sys Mgmt Util M-Z, 4-20 
removing, Sys Mgmt Util M-Z, 4-41 
CLUSTER class record 

in Monitor utility, Sys Mgmt Util M-Z, A-ll 
CLUSTER information 

SHOW CLUSTER class of data, Sys Mgmt Util 
M-Z, 4-3 

Cluster performance statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1—15 
/CLUSTER qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-14 
CLUSTER_AUTHORIZE.DAT files, Sys Mgmt 
Util M-Z, 6-15, 6-18 

CLUSTER_CONFIG.COM command procedure, 
Sys Mgmt Util M-Z, 6—15 
Command interpreter 

symbol table, Sys Mgmt Util M-Z, C—11 
Command mode for Audit Analysis utility 
manipulating the display interactively, Sys 
Mgmt Util A-L, 4—10, 4—25 
Command procedures 

building, Sys Mgmt Util M-Z, 4-48 
control for SHOW CLUSTER output, Sys 
Mgmt Util M-Z, 4—4 
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Command procedures (cont’d) 

correcting system time, Sys Mgmt Util M-Z 
6-17 

executing, Sys Mgmt Util A-L, 12-7; Sys 
Mgmt Util M-Z, 4-11 
in SYSMAN, Sys Mgmt Util M-Z, 6-9 
executing at system startup, Sys Mgmt Util 
M-Z, 6-66 

executing DCL commands with DO, Sys Mgmt 
Util M-Z, 6-30 

parameters for, Sys Mgmt Util A-L, 12-7 
Commands 

recalling, Sys Mgmt Util A-L, 13-23 
Command summary 

of Authorize utility commands, Sys Mgmt Util 
A-L, 5—6 

Command syntax, Sys Mgmt Util A-L, 7-5 
/COMMENT qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-22 
in Monitor utility, Sys Mgmt Util M-Z, 1-10 
in Mount utility, Sys Mgmt Util M-Z, 2-15 
Compaction of data 
See Data compaction 

Compare operations, Sys Mgmt Util A-L, 7-23 
/COMPARE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-23 
CONCEAL_DEVICES system parameter, Sys 
Mgmt Util M-Z, C-52 
CONFIGURATION SET CLUSTER_ 
AUTHORIZATION command 
in SYSMAN, Sys Mgmt Util M-Z, 6-15 
CONFIGURATION SET TIME command 
in SYSMAN, Sys Mgmt Util M-Z, 6-16 
CONFIGURATION SHOW CLUSTER_ 
AUTHORIZATION command 
in SYSMAN, Sys Mgmt Util M-Z, 6-17 
CONFIGURATION SHOW TIME command 
in SYSMAN, Sys Mgmt Util M-Z, 6-18 
CONFIGURE command 

i n POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-5 
in SYSGEN, Sys Mgmt Util M-Z, 5-7 
Configuring a printer, Sys Mgmt Util A-L, 13-10 
/CONFIRM qualifier 

in Analyze/DiskjStructure utility, Sys Mgmt 
Util A-L, 3-7 

in Backup utility, Sys Mgmt Util A-L, 7-24 
in Mount utility, Sys Mgmt Util M-Z, 2-16 
CONNECT/ADAPTER command 

in SYSGEN, Sys Mgmt Util M-Z, 5-9 
Connecting devices, Sys Mgmt Util M-Z, 5-5, 5-9 
on Alpha systems, Sys Mgmt Util M-Z, 6-34 
Connections 

in LAT environment, Sys Mgmt Util A-L 
13-32, 13-57 

specifying type with LATCP, Sys Mgmt Util 
A-L, 13-27 


CONNECTIONS class 

adding or restoring, Sys Mgmt Util M-Z, 4-14 
fields belonging to, Sys Mgmt Util M-Z, 4-21 
removing, Sys Mgmt Util M-Z, 4-42 
CONNECT NODE command 


in LANCP utility, Sys Mgmt Util A-L, 12-10 
CONTINUE command 


in Audit Analysis utility, Sys Mgmt Util A-L 
4-25 

/CONTINUOUS qualifier, Sys Mgmt Util M-Z 
4-7 

CONVERT command 

in Monitor utility, Sys Mgmt Util M-Z, 1-5 
CONVERT LOG command 

in LMCP, Sys Mgmt Util A-L, 14-5 
COPY command 

in Authorize utility, Sys Mgmt Util A-L, 5-24 
in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-7 

Copying a software kit, Sys Mgmt Util M-Z 3-7 
/COPY qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-17 
Counters, Sys Mgmt Util A-L, 13-3 
displaying 

for links, Sys Mgmt Util A-L, 13-42 
for nodes, Sys Mgmt Util A-L, 13-47 
for ports, Sys Mgmt Util A-L, 13-52 
for services, Sys Mgmt Util A-L, 13-57 
resetting, Sys Mgmt Util A-L, 13-60 
COUNTERS class 

adding, Sys Mgmt Util M-Z, 4-15 
fields belonging to, Sys Mgmt Util M-Z, 4-22 
removing, Sys Mgmt Util M-Z, 4-43 
CPU power 

in LAT environment, Sys Mgmt Util A-L 
13-28 


Crash Log Utility Extractor (CLUE) 
commands, Sys Mgmt Util A-L, 8-5 
DELETE command in, Sys Mgmt Util A-L, 8-5 
DIRECTORY command in, Sys Mgmt Util A-L 
8 —6 

EXIT command in, Sys Mgmt Util A-L, 8-7 
exiting from, Sys Mgmt Util A-L, 8-4 
EXTRACT command in, Sys Mgmt Util A-L 
8-7 


HELP command in, Sys Mgmt Util A-L, 8-8 
invoking, Sys Mgmt Util A-L, 8-4 
SHOW command in, Sys Mgmt Util A-L, 8-8 
/CRC qualifier 

as Backup utility input save-set qualifier, Sys 
Mgmt Util A-L, 7-25 

as Backup utility output save-set qualifier, Sys 
Mgmt Util A-L, 7-25 

CRDENABLE system parameter, Sys Mgmt Util 
M-Z, C-ll 
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CRD_CONTROL system parameter, Sys Mgmt 
Util M-Z, C-ll 
CREATE command 

in Install utility, Sys Mgmt Util A-L, 11-8 
in SYSGEN, Sys Mgmt Util M-Z, 5-11 
/CREATED qualifier 

in Backup utility, Sys Mgmt Util A-L, 7—26 
CREATE LINK command 

in LATCP, Sys Mgmt Util A-L, 13-7 

illegal SCSSYSTEMID system parameter, 

Sys Mgmt Util A-L, 13-7 
CREATE LOG command 

in LMCP, Sys Mgmt Util A-L, 14-7 
CREATE PORT command 

in LATCP, Sys Mgmt Util A-L, 13-9 
CREATE/PROXY command 

in Authorize utility, Sys Mgmt Util A-L, 5—25 
CREATE/RIGHTS command 

in Authorize utility, Sys Mgmt Util A-L, 5—26 
CREATE SERVICE command 

in LATCP, Sys Mgmt Util A-L, 13-14 
Creating a disk usage accounting file, Sys Mgmt 
Util A-L, 3-11 

Creator ACEs, Sys Mgmt Util A-L, 1-9 

specifying access, Sys Mgmt Util A-L, 1—10 
specifying attributes, Sys Mgmt Util A-L, 1-10 
CREDITS class 

adding, Sys Mgmt Util M-Z, 4-17 
fields belonging to, Sys Mgmt Util M-Z, 4-23 
removing, Sys Mgmt Util M-Z, 4-43 
CSR (Control and Status Register) 

addresses, Sys Mgmt Util M-Z, 5—7, 5—9 
fixed space, Sys Mgmt Util M-Z, D—1 
floating space, Sys Mgmt Util M-Z, D—1 
vector addresses, Sys Mgmt Util M-Z, 5-9 
CSR addresses 

display on Alpha systems, Sys Mgmt Util M-Z, 
6-39 

CTLIMGLIM system parameter, Sys Mgmt Util 
M-Z, C—52 

CTLPAGES system parameter, Sys Mgmt Util 
M-Z, C-52 

D___ 

Data collection 

by AUTOGEN, Sys Mgmt Util A-L, 6-6 
Data compaction 

TA90E support, Sys Mgmt Util A-L, 7-46 
volume mount, Sys Mgmt Util M-Z, 2—24 
Data field, Sys Mgmt Util M-Z, 4-3 
Data link 

creating with LATCP, Sys Mgmt Util A-L, 13—7 
modifying LAT characteristics of, Sys Mgmt 
Util A-L, 13-26 

number supported by LAT software, Sys Mgmt 
Util A-L, 13-9 


/DATA_CHECK qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-18 
Dates 

See also SYSMAN command CONFIGURATION 
SHOW TIME 

displaying in a VMScluster, Sys Mgmt Util 
M-Z, 6-18 
DCL commands 

in SYSMAN, Sys Mgmt Util M-Z, 6-30 
DEADLOCK_WAIT system parameter, Sys Mgmt 
Util M-Z, C-12 

DECdtm transaction manager, Sys Mgmt Util 
M-Z, A-41 
DECevent 

See DECevent utility 
DECevent utility 

/BEFORE qualifier, Sys Mgmt Util A-L , 9-6 
/BINARY qualifier, Sys Mgmt Util A-L , 9-6 
/BRIEF qualifier, Sys Mgmt Util A-L , 9-7 
brief report example, Sys Mgmt Util A-L , 9-22 
/CONTINUOUS qualifier, Sys Mgmt Util A-L, 
9-7 

device classes, Sys Mgmt Util A-L , 9—9 
excluding, Sys Mgmt Util A-L , 9—9 
including, Sys Mgmt Util A-L , 9-13 
device name, Sys Mgmt Util A-L , 9—13 
excluding, Sys Mgmt Util A-L , 9—10 
including, Sys Mgmt Util A-L , 9—13 
device name constructs, Sys Mgmt Util A-L, 
9-10 

/DUMP qualifier, Sys Mgmt Util A-L , 9-8 
/ENTRY qualifier, Sys Mgmt Util A-L , 9-8 
entry type 

excluding, Sys Mgmt Util A-L , 9—10 
including, Sys Mgmt Util A-L , 9—13 
error log file, Sys Mgmt Util A-L , 9—17 
events reported 

selecting date, Sys Mgmt Util A-L, 9—6, 
9-18 

selecting time, Sys Mgmt Util A-L, 9-6, 
9-18 
examples 

/BEFORE qualifier, Sys Mgmt Util A-L, 
9-6 

/BINARY qualifier, Sys Mgmt Util A-L, 
9—7 

/EXCLUDE qualifier, Sys Mgmt Util A-L, 9-9 
fast error report example, Sys Mgmt Util A-L, 
9-24 

/FSTERR qualifier, Sys Mgmt Util A-L, 9-12 
/FULL qualifier, Sys Mgmt Util A-L, 9-12 
full report example, Sys Mgmt Util A-L, 9-21 
/INCLUDE qualifier, Sys Mgmt Util A-L, 9-13 
informational messages, Sys Mgmt Util A-L, 
9-16 

/INTERACTIVE qualifier, Sys Mgmt Util A-L, 
9-15 

/LOG qualifier, Sys Mgmt Util A-L, 9—16 
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DECevent utility (cont’d) 

/NODE qualifier, Sys Mgmt Util A-L, 9-16 
output 

binary format, Sys Mgmt Util A-L, 9-6 
directing, Sys Mgmt Util A-L, 9-6, 9-16 
9-17 

file specification, Sys Mgmt Util A-L 9-6 
9-17 

output file, Sys Mgmt Util A-L, 9-17 
/OUTPUT qualifier, Sys Mgmt Util A-L, 9-17 
qualifiers, Sys Mgmt Util A-L, 9-5 to 9-20 
/REJECTED qualifier, Sys Mgmt Util A-L 
9-17 

report examples, Sys Mgmt Util A-L, 9-21 to 
9-25 

report format 

binary, Sys Mgmt Util A-L, 9-6, 9-13 
9-17 

brief, Sys Mgmt Util A-L, 9-7, 9-8 
fast error, Sys Mgmt Util A-L, 9-12 
full, Sys Mgmt Util A-L, 9-12 
rejected entries, Sys Mgmt Util A-L, 9-17 
summary, Sys Mgmt Util A-L, 9-19 
terse, Sys Mgmt Util A-L, 9-19 
/SINCE qualifier, Sys Mgmt Util A-L, 9-18 
/SUMMARY qualifier, Sys Mgmt Util A-L, 9-19 
summary report example, Sys Mgmt Util A-L 
9-24 

/TERSE qualifier, Sys Mgmt Util A-L, 9-19 
terse report example, Sys Mgmt Util A-L, 9-23 
/TRANSLATE qualifier, Sys Mgmt Util A-L 
9-20 
DECnet 

LAT software 

effect of SCSSYSTEMID system parameter, 
Sys Mgmt Util A-L , 13-7 
DECNET class record 

in Monitor utility, Sys Mgmt Util M-Z, A-13 
DECservers 

changing device characteristics, Sys Mgmt Util 
A-L , 13-10, 13-35 

Dedicated port, Sys Mgmt Util A-L , 13-10, 13-36 
displaying, Sys Mgmt Util A-L , 13-52 
DEFAULT command 

in Authorize utility, Sys Mgmt Util A-L , 5-27 
Default parameter file, Sys Mgmt Util A-L , 6-7 
Default protection 

for NET$PROXY.DAT, Sys Mgmt Util A-L , 5-3 
for NETPROXY.DAT, Sys Mgmt Util A-L , 5-3 
for RIGHTSLIST.DAT, Sys Mgmt Util A-L , 5-3 
for SYSUAF.DAT, Sys Mgmt Util A-L , 5-3 
Default Protection ACEs, Sys Mgmt Util A-L 
1-11 

Default user authorization records 
modifying, Sys Mgmt Util A-L , 5-27 
DEFINE command 

in SYSMAN, Sys Mgmt Util M-Z , 6-19 


DEFINE DEVICE command 

in LANCP utility, Sys Mgmt Util A-L , 12-11 

DEFINE/KEY command, Sys Mgmt Util M-Z B-3 
in LATCP, Sys Mgmt Util A-L , 13-17 
in Show Cluster utility, Sys Mgmt Util M-Z 
4—33 

DEFINE NODE command 

in LANCP utility, Sys Mgmt Util A-L , 12-13 

Defining keys, Sys Mgmt Util M-Z , 6-19 

to execute SYSMAN commands, Sys Mgmt Util 
M-Z , 6-3 

DEFMBXBUFQUO system parameter, Sys Mgmt 
Util M-Z , C-12 

DEFMBXMXMSG system parameter, Sys Mgmt 
Util M-Z , C-12 

DEFPRI system parameter, Sys Mgmt Util M-Z 
C-12 


u&ryUEFRI system parameter, Sys Mgmt Util 
M-Z, C-12 

DEINSTALL command 

in SYSGEN, Sys Mgmt Util M-Z, 5-11 
DELETE command 

in CLUE, Sys Mgmt Util A-L, 8-5 
in Install utility, Sys Mgmt Util A-L, 11-10 
DELETE LINK command 

in LATCP, Sys Mgmt Util A-L, 13-19 
DELETE PORT command 

in LATCP, Sys Mgmt Util A-L, 13-20 
/DELETE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-26 
DELETE QUEUE_ENTRY command 
in LATCP, Sys Mgmt Util A-L, 13-21 
DELETE SERVICE command 

in LATCP, Sys Mgmt Util A-L, 13-21 
/DENSITY qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-27 
in Mount utility, Sys Mgmt Util M-Z, 2-19 
DESELECT command 

m Show Cluster utility, Sys Mgmt Util M-Z 
4-35 


Device addresses 
See LAN addresses 
Device drivers 

addresses, Sys Mgmt Util M-Z, 5-28 
configuring, Sys Mgmt Util M-Z, 5-5, 5-27 
connecting, Sys Mgmt Util M-Z, 5-9 
displaying on Alpha systems, Sys Mgmt Util 
M-Z, 6-40 

loading, Sys Mgmt Util M-Z, 5-5, 5-9, 5-14 
loading on Alpha systems, Sys Mgmt Util M-Z, 


replacing with new version of, Sys Mgmt Util 
M-Z, 5-15 

showing configuration of, Sys Mgmt Util M-Z 
5-24 

showing information, Sys Mgmt Util M-Z 
5-27, 5-28 
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Device names 

specifying, Sys Mgmt Util M-Z , 5—7, 5—9 
Devices 

configuring VAXstation 2000 and MicroVAX 
2000 devices, Sys Mgmt Util M-Z, D-6 
connecting on Alpha systems, Sys Mgmt Util 
M-Z, 6-33, 6-34 

Digital supplied, Sys Mgmt Util M-Z, D-l 
displaying the default, Sys Mgmt Util M-Z, 

6-58 

excluding, Sys Mgmt Util M-Z, 6-38 
logical name translation, Sys Mgmt Util M-Z, 
6-22 

setting defaults for file specifications, Sys 
Mgmt Util M-Z , 6—54 

specifying quotas for, Sys Mgmt Util M-Z , 6-21 
Device seed, Sys Mgmt Util A-L, 13—28 
Device table, Sys Mgmt Util M-Z , D-l 
Device types 

codes, Sys Mgmt Util M-Z , 5-6 
descriptions, Sys Mgmt Util M-Z , 5—6 
Digital writers 

sending comments to, Sys Mgmt Util A-L , in, 
Sys Mgmt Util M-Z , iii 

Directing ANALYZE/DISK.STRUCTURE output, 
Sys Mgmt Util A-L , 3-6, 3-9 
Directing SYSGEN output, Sys Mgmt Util M-Z , 
5-4, 5-7, 5-16 
Directories 

access to files created in, Sys Mgmt Util A-L , 
1-9 

and Default Protection ACEs, Sys Mgmt Util 
A-L , 1-11 

assigning a Creator ACE to, Sys Mgmt Util 
A-L, 1-9 

creating for a new account, Sys Mgmt Util A-L, 
5-19 

determining access to files created in, Sys 
Mgmt Util A-L, 1-11 
ownership 

changing access to files, Sys Mgmt Util 
A-L, 1-9 
Directory backlinks 

definition, Sys Mgmt Util A-L, 3—3 
DIRECTORY command 

in CLUE, Sys Mgmt Util A-L, 8-6 
Directory default 

displaying, Sys Mgmt Util M-Z, 6—58 
modifying, Sys Mgmt Util M-Z, 6-54 
Directory trees 

propagating UlC-based protection, Sys Mgmt 
Util A-L, 1-11 

restoring, Sys Mgmt Util A-L, 7-9 
DISABLE command 

in SYSGEN, Sys Mgmt Util M-Z, 5-12 
DISK class record 

in Monitor utility, Sys Mgmt Util M-Z, A-14 


DISKQUOTA ADD command 

in SYSMAN, Sys Mgmt Util M-Z, 6-21 
DISKQUOTA CREATE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-22 
DISKQUOTA DELETE command 
See DISKQUOTA REMOVE 
in SYSMAN, Sys Mgmt Util M-Z, 6-23 
DISKQUOTA DISABLE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-23 
DISKQUOTA ENABLE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-24 
DISKQUOTA MODIFY command 

in SYSMAN, Sys Mgmt Util M-Z, 6-25 
DISKQUOTA REBUILD command 

in SYSMAN, Sys Mgmt Util M-Z, 6-26 
DISKQUOTA REMOVE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-27 
Disk quotas 

creating, Sys Mgmt Util M-Z , 6-22 
disabling, Sys Mgmt Util M-Z , 6—23 
displaying, Sys Mgmt Util M-Z , 6-29 

me . 

adding entry, Sys Mgmt Util M-Z , 6—21 
initializing usage count, Sys Mgmt Util 
M-Z , 6-21 

modifying an entry, Sys Mgmt Util M-Z , 6—25 
rebuilding, Sys Mgmt Util M-Z , 6—26 
removing an entry, Sys Mgmt Util M-Z , 6—23, 
6-27 

DISKQUOTA SHOW command 

in SYSMAN, Sys Mgmt Util M-Z , 6-29 
Disks 

making a group available 

volume, Sys Mgmt Util M-Z , 2—21 
making a public volume, Sys Mgmt Util M-Z , 
2-36 

mounting, Sys Mgmt Util M-Z , 2-4 

clusterwide, Sys Mgmt Util M-Z , 2-4, 2-14 
for volume shadowing, Sys Mgmt Util M-Z , 
2-16, 2-17, 2-34 
shareable volume 

specifying, Sys Mgmt Util M-Z , 2—35 
Disk statistics 

in Monitor utility, Sys Mgmt Util M-Z , 1-20 
Disk usage accounting file, Sys Mgmt Util A-L , 
E-l 

Disk volumes 
See also Disks 

disabling automatic rebuild, Sys Mgmt Util 
M-Z , 2-32 

overriding protection checks, Sys Mgmt Util 
M-Z , 2-27 

physical loading, Sys Mgmt Util M-Z , 2—3, 
2-38 

rebuilding, Sys Mgmt Util M-Z , 2—32 
repairing errors, Sys Mgmt Util A-L , 3-11 
verification, Sys Mgmt Util A-L , 3—3 
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DISK_QUORUM system parameter, Sys Mgmt 
Util M-Z, C-12 

DIS MOU MS G system parameter, Sys Mgmt Util 
M-Z, C-12 
DISPLAY command 

in Audit Analysis utility, Sys Mgmt Util A-L, 


Display from SHOW CLUSTER 

display formatting, Sys Mgmt Util M-Z 4-4 
/DISPLAY qualifier 

in Monitor utility, Sys Mgmt Util M-Z , 1-10 
Displays 

refreshing screen with LATCP, Sys Mgmt Util 
A-L, 13-24 


SHOW CLUSTER, Sys Mgmt Util M-Z, 4—4 
Distributed lock management statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1-23 
DLCEXTRASTK system parameter, Sys Mgmt 
Util M-Z, C-52 
DLOCK class record 

in Monitor utility, Sys Mgmt Util M-Z, A-16 
DNVOSI system parameter, Sys Mgmt Util M-Z 
C-53 


DO command 


in SYSMAN, Sys Mgmt Util M-Z, 6-30 
Documentation 

sending comments to Digital writers, Sys 
Mgmt Util A-L, iii; Sys Mgmt Util M-Z, iii 
DORMANTWAIT system parameter, Sys Mgmt 
Util M-Z, C-12 


DR_UNIT_BASE system parameter, Sys Mgmt 
Util M-Z, C-13 

Dual-architecture VMSclusters 

installing images, Sys Mgmt Util M-Z, 6-30 
example, Sys Mgmt Util M-Z, 6-31 
DUMPBUG system parameter, Sys Mgmt Util 
M-Z, C-13 
DUMP command 

in LMCP, Sys Mgmt Util A-L, 14-8 
Dump files 

changing size, Sys Mgmt Util A-L, 6-3 
displaying the size calculated by AUTOGEN, 
Sys Mgmt Util A-L, 6-7 
generating a new file sized by AUTOGEN, Sys 
Mgmt Util A-L, 6-7 

DUMPSTYLE system parameter, Sys Mgmt Util 
M-Z, C-13 


Dynamic attributes, Sys Mgmt Util A-L, 5-21 
5—29, 5—37 
Dynamic parameters 

modifying, Sys Mgmt Util M-Z, 5-33, 6-51 
Dynamic service rating, Sys Mgmt Util A-L 
13-15, 13-40 

displaying, Sys Mgmt Util A-L, 13-51, 13-58 


E 

EDIT/ACL command, Sys Mgmt Util A-L, 1-4 

See also ACL editor 
Editing ACLs 

See ACL editor 
Editing sessions 

keypad for ACL editing, Sys Mgmt Util A-L, 

A—1 

EDIT keypad function, Sys Mgmt Util M-Z, 4-33, 
B—3 

ENABLE command 

in SYSGEN, Sys Mgmt Util M-Z, 5-13 
/ENDING qualifier, Sys Mgmt Util M-Z, 4-7 
in Monitor utility, Sys Mgmt Util M-Z, 1-10 
END phase, Sys Mgmt Util M-Z, 6-71 
End phase of AUTOGEN, Sys Mgmt Util A-L, 6-5 
default, Sys Mgmt Util A-L, 6-10 
Environment 
defining 

in SYSMAN, Sys Mgmt Util M-Z, 6-53 
Erasing blocks, Sys Mgmt Util A-L, 3-5 
Erasing home blocks, Sys Mgmt Util A-L 3-8 
ERLBUFFERPAGES system parameter, Sys 
Mgmt Util M-Z, C-14 

ERRORLOGBUFFERS system parameter, Sys 
Mgmt Util M-Z, C-14 
Error Log utility (ERROR LOG) 

/BEFORE qualifier, Sys Mgmt Util A-L, 10-6 
/BINARY qualifier, Sys Mgmt Util A-L, 10-6 
/BRIEF qualifier, Sys Mgmt Util A-L, 10-7 
buffered I/O count reporting, Sys Mgmt Util 
A-L, 10-18 

device classes, Sys Mgmt Util A-L, 10-8, 10-11 
excluding, Sys Mgmt Util A-L, 10-8 
including, Sys Mgmt Util A-L, 10-11 
device name 

excluding, Sys Mgmt Util A-L, 10-8 
including, Sys Mgmt Util A-L, 10-12 
device name constructs, Sys Mgmt Util A-L 
10-8 

direct I/O count reporting, Sys Mgmt Util A-L 
10-18 

directing output, Sys Mgmt Util A-L, 10-4 
/ENTRY qualifier, Sys Mgmt Util A-L, 10-7 
entry type 

excluding, Sys Mgmt Util A-L, 10-9 
including, Sys Mgmt Util A-L, 10-12 
error log file 

input file, Sys Mgmt Util A-L, 10-4 
specifying output, Sys Mgmt Util A-L 
10-15 

events reported, Sys Mgmt Util A-L, 10-3 
selecting date, Sys Mgmt Util A-L, 10-6 
10-17 

selecting time, Sys Mgmt Util A-L 10-6 
10-17 
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Error Log utility (ERROR LOG) (cont d) 

examples, Sys Mgmt Util A-L, 10-19 to 10-32 
/BEFORE qualifier, Sys Mgmt Util A-L, 
10-6 

brief report, Sys Mgmt Util A-L, 10-32 
machine check, Sys Mgmt Util A-L, 10-21 
memory error, Sys Mgmt Util A-L, 10—28 
nonfatal and user bugchecks, Sys Mgmt 
Util A-L, 10-29 

time-stamp, Sys Mgmt Util A-L, 10-20 
volume dismount, Sys Mgmt Util A-L, 
10-20 

volume mount, Sys Mgmt Util A-L, 10-20 
/EXCLUDE qualifier, Sys Mgmt Util A-L, 10-8 
execution time event reporting, Sys Mgmt Util 


A-L, 10-18 

exiting from, Sys Mgmt Util A-L, 10-4 
/FULL qualifier, Sys Mgmt Util A-L, 10—11 
I/O events, Sys Mgmt Util A-L, 10-18 
buffered, Sys Mgmt Util A-L, 10-18 
direct, Sys Mgmt Util A-L, 10-18 
/INCLUDE qualifier, Sys Mgmt Util A-L, 10-11 
invoking, Sys Mgmt Util A-L, 10-4 
/LOG qualifier, Sys Mgmt Util A-L, 10-14 
messages 

informational, Sys Mgmt Util A-L, 10—14 
/MODEL qualifier, Sys Mgmt Util A-L, 10-14 
/NODE qualifier, Sys Mgmt Util A-L, 10-14 
output 

ASCII format, Sys Mgmt Util A-L, 10-6 
binary format, Sys Mgmt Util A-L, 10-6 
directing, Sys Mgmt Util A-L, 10—6, 10—14, 
10-15, 10-16 

file specification, Sys Mgmt Util A-L, 10-6, 


10-15 

output file, Sys Mgmt Util A-L, 10—15 
/OUTPUT qualifier, Sys Mgmt Util A-L, 10-15 
page faults reported, Sys Mgmt Util A-L, 10-18 
qualifiers, Sys Mgmt Util A-L, 10—5 to 10-18 
/REGISTER_DUMP qualifier, Sys Mgmt Util 


A-L, 10-16 

/REJECTED qualifier, Sys Mgmt Util A-L, 
10-16 

report format 

ASCII, Sys Mgmt Util A-L, 10-6, 10-7 
binary, Sys Mgmt Util A-L, 10—6, 10—11, 
10-16 

brief, Sys Mgmt Util A-L, 10-7 
full, Sys Mgmt Util A-L, 10-11 
hexadecimal longword, Sys Mgmt Util A-L, 


10-16 

register dump, Sys Mgmt Util A-L, 10—16 
rejected entries, Sys Mgmt Util A-L, 10-16 
run-time statistics, Sys Mgmt Util A-L, 
10-17, 10-18 

restrictions, Sys Mgmt Util A-L, 10-4 
sample error log report, Sys Mgmt Util A-L, 
10-19 


Error Log utility (ERROR LOG) (cont’d) 

/SIB REGISTER qualifier, Sys Mgmt Util A-L, 
10-17 

/SINCE qualifier, Sys Mgmt Util A-L, 10-17 
/STATISTICS qualifier, Sys Mgmt Util A-L, 

10-18 

Errors 

repair, Sys Mgmt Util A-L, 3-3, 3-7, 3-8, 3-10, 
3-H 

reporting, Sys Mgmt Util A-L , 3-3 
ERRORS class 

adding, Sys Mgmt Util M-Z , 4-18 

fields belonging to, Sys Mgmt Util M-Z , 4-23 

removing, Sys Mgmt Util M-Z , 4-44 

Ethernet address 
See LAN addresses 
Ethernet controllers 
See LAN controllers 
Ethernet link 
See Data link 
Event classes 

extracting audit records by, Sys Mgmt Util 
A-L, 4-7 
Event records 

See Security audit reports 
Event types, Sys Mgmt Util A-L, 4-7 
/EXACT_ORDER qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-27 
Examples 

annotated, Sys Mgmt Util A-L, D-4 to D-8 
comparing files, Sys Mgmt Util A-L, 7—24 
creating a disk usage accounting file, Sys 
Mgmt Util A-L, 3-11 

creating a journal file, Sys Mgmt Util A-L, 

7-41 

image save operation, Sys Mgmt Util A-L,l-ol 
incremental save operation, Sys Mgmt Util 
A-L, 7-38 . 

initializing an output disk, Sys Mgmt Util A-L, 
7-39 

list operation, Sys Mgmt Util A-L, 7-19 
protecting an output save-set, Sys Mgmt Util 
A-L, 7-51 

repairing errors on a disk volume, Sys Mgmt 
Util A-L, 3-11 

selective backup, Sys Mgmt Util A-L, 7-16, 
7-17 

specifying a save-set label, Sys Mgmt Util A-L, 
7-44 

specifying block size, Sys Mgmt Util A-L, 7—1 
specifying density for magnetic tape, Sys Mgmt 
Util A-L, 7-27 

specifying redundancy group blocks, Sys Mgmt 
Util A-L, 7-33 

using wildcard characters, Sys Mgmt Util A-L, 
7-8 
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/EXCLUDE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-30 
Excluding devices, Sys Mgmt Util M-Z, 6-38 
Exclusion list 

displaying, Sys Mgmt Util M-Z , 6-41 
EXECUTE command 

m Monitor utility, Sys Mgmt Util M-Z, 1-6 
Execute procedure (@) command 

in LANCP utility, Sys Mgmt Util A-L, 12-7 
in Show Cluster utility, Sys Mgmt Util M-Z, 


to set up SHOW CLUSTER format, Sys Mgmt 
Util M-Z, 4-11 
Execution modes 


CHECK_FEEDBACK, Sys Mgmt Util A-L 6-8 
FEEDBACK, Sys Mgmt Util A-L, 6-8 
INITIAL, Sys Mgmt Util A-L, 6-8 
NOFEEDBACK, Sys Mgmt Util A-L, 6-8 
EXIT command, Sys Mgmt Util M-Z, 6-32 
in Audit Analysis utility, Sys Mgmt Util A-L 
4-27 


in Authorize utility, Sys Mgmt Util A-L, 5-28 
in CLUE, Sys Mgmt Util A-L, 8-7 
in Install utility, Sys Mgmt Util A-L, 11-11 
in LANCP utility, Sys Mgmt Util A-L, 12-16 
in LATCP, Sys Mgmt Util A-L, 13-22 
in Monitor utility, Sys Mgmt Util M-Z, 1-7 
in Show Cluster utility, Sys Mgmt Util M-Z 
4-35 


in SYSMAN, Sys Mgmt Util M-Z, 6-32 
Exiting from SYSGEN, Sys Mgmt Util M-Z 5—4 
Exiting from SYSMAN, Sys Mgmt Util M-Z, 6-5 
EXPECTED_VOTES system parameter, Sys 
Mgmt Util M-Z, C-14 
/EXPIRED qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-31 
/EXTENSION qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-19 
EXTRACPU system parameter, Sys Mgmt Util 
M-Z, C-14 
EXTRACT command 

in CLUE, Sys Mgmt Util A-L, 8-7 
EXTRACT RELEASE_NOTES command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-9 
EXUSRSTK system parameter, Sys Mgmt Util 
M-Z, C-53 


F 

/FAST qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-31 
FCP class record 

in Monitor utility, Sys Mgmt Util M-Z, A-17 
Feedback 

See AUTOGEN, feedback 


FEEDBACK mode, Sys Mgmt Util A-L, 6-3, 6-8 
Feedback on documentation 

sending comments to Digital writers, Sys 

Mgmt Util A-L , iii; Sys Mgmt Util M-Z, iii 
Field of data 

definition, Sys Mgmt Util M-Z , 4-19 
definition of each, Sys Mgmt Util M-Z, 4-28 
removing, Sys Mgmt Util M-Z , 4-44 
Fields 

SHOW CLUSTER, Sys Mgmt Util M-Z , 4-3 
File backward link records 

in accounting files, Sys Mgmt Util A-L , 2-29 
File forward link records 

in accounting files, Sys Mgmt Util A-L , 2-29 
File primitive statistics 

in Monitor utility, Sys Mgmt Util M-Z 1-25 
Files 

AGEN$FEEDBACK.DAT, Sys Mgmt Util A-L 
6-5 

AGEN$FEEDBACK.EXE, Sys Mgmt Util A-L, 
6-5 

AGEN$PARAMS.REPORT, Sys Mgmt Util A-L 
6-7 

ALPHAVMSSYS.OLD, Sys Mgmt Util A-L 6-7 
ALPHAVMSSYS.PAR, Sys Mgmt Util A-L, 6-7 
AUTOGEN.PAR, Sys Mgmt Util A-L, 6-6, 6-7; 

Sys Mgmt Util M-Z, 5-32, 5-33 
containing AUTOGEN feedback, Sys Mgmt 
Util A-L, 6-5 

containing list of known images, Sys Mgmt 
Util A-L, 6-7 

controlling access to, Sys Mgmt Util A-L 1-11 
1-13 
creating 

dependency on directory ownership, Sys 
Mgmt Util A-L, 1-9 

creating in a directory with a Default Protection 
ACE, Sys Mgmt Util A-L, 1-11 
default parameter, Sys Mgmt Util A-L, 6-7 
device driver, Sys Mgmt Util M-Z, 5-15 
format required by ACL editor, Sys Mgmt Util 
A-L, 1-4 

for paging, Sys Mgmt Util A-L, 6-7 
for swapping, Sys Mgmt Util A-L, 6-7 
for system crash dumps, Sys Mgmt Util A-L 
6-7 

I/O driver, Sys Mgmt Util M-Z, 5-14 
input of device list, Sys Mgmt Util M-Z, 5-7 
output cluster report, Sys Mgmt Util M-Z 4-8 
4-55 

parameter, Sys Mgmt Util A-L, 6-5, 6-7; Sys 
Mgmt Util M-Z, 5-33 
PARAMS.DAT, Sys Mgmt Util A-L, 6-6 
restoring to original directories, Sys Mgmt Util 
A-L, 7-9 

SETPARAMS.DAT, Sys Mgmt Util A-L, 6-7 
SHOW_CLUSTER.LIS, Sys Mgmt Util M-Z 
4-8, 4-55 
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Files (cont’d) 

startup, Sys Mgmt Util M-Z, 6-65 

disabling, Sys Mgmt Util M-Z, 6-67 
displaying, Sys Mgmt Util M-Z, 6-73 
startup command procedure, Sys Mgmt Util 
M-Z, 5-17, 5-29, 5-33 

SYSGEN session output, Sys Mgmt Util M-Z, 

5- 4, 5-16 

SYSGTTSTR.MSG, Sys Mgmt Util M-Z, 5-31 
SYSMAN.LIS, Sys Mgmt Util M-Z, 6-13, 6-17, 

6- 18, 6-29, 6-30, 6-31, 6-48, 6-74 
system parameter, Sys Mgmt Util M-Z, 5-32, 

5-33 

UlC-based protection 

propagating in a directory tree, Sys Mgmt 
Util A-L, 1-11 

used by AUTOGEN command procedure, Sys 
Mgmt Util A-L, 6—9 

VAXVMSSYS.OLD, Sys Mgmt Util A-L, 6-7 
VAXVMSSYS.PAR, Sys Mgmt Util A-L, 6-7; 

Sys Mgmt Util M-Z, 5—33 
VMSIMAGES.DAT, Sys Mgmt Util A-L, 6-7 
writing alarm messages to audit logs, Sys 
Mgmt Util A-L, 1-8 

File system cache (ACP) system parameters 
in Monitor utility, Sys Mgmt Util M-Z, 1-29 
File system cache statistics 

monitoring, Sys Mgmt Util M-Z , 1—26 
File types 

specifying for ACL editor, Sys Mgmt Util A-L , 
1-4 

File window mapping pointers 

allocating, Sys Mgmt Util M-Z , 2-39 
FILE_SYSTEM_CACHE class record 

in Monitor utility, Sys Mgmt Util M-Z , A-19 
FIND command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z , 3-10 

Flags 

login, Sys Mgmt Util A-L , 5—11 
Floating address, Sys Mgmt Util M-Z , D-l 
/FLUSHJNTERVAL qualifier 

in Monitor utility, Sys Mgmt Util M-Z , 1-10 
/FOREIGN qualifier 

in Mount utility, Sys Mgmt Util M-Z , 2-20 
Foreign volumes 

mounting, Sys Mgmt Util M-Z , 2-20 
Format for SHOW CLUSTER 

specifying processor types, Sys Mgmt Util M-Z , 
4-31 

FREEGOAL system parameter, Sys Mgmt Util 
M-Z , C-15 

FREELIM system parameter, Sys Mgmt Util M-Z , 
C-15 

FSTERR report 

example, Sys Mgmt Util A-L , 9—25 


/FULL qualifier 

in Backup utility, Sys Mgmt Util A-L , 7-32 
Full report 

example, Sys Mgmt Util A-L , 9—21 
Function keys, Sys Mgmt Util A-L , 13-17 


G__ 

GBLPAGES system parameter, Sys Mgmt Util 

M-Z, C-15 

GBLPAGFIL system parameter, Sys Mgmt Util 
M-Z, C-15 

GBLSECTIONS system parameter, Sys Mgmt 
Util M-Z, C-16 
Generic names 

showing, Sys Mgmt Util M-Z, 5—23, 5—24 
GENFILES phase of AUTOGEN, Sys Mgmt Util 
A-L, 6-7 

GENPARAMS phase of AUTOGEN, Sys Mgmt 

Util A-L, 6-7 

GETDATA phase of AUTOGEN, Sys Mgmt Util 
A-L, 6-6 

GH_EXEC_CODE system parameter, Sys Mgmt 
Util M-Z, C-16 

GH_EXEC_DATA system parameter, Sys Mgmt 
Util M-Z, C-16 

GH_RES_CODE system parameter, Sys Mgmt 
Util M-Z, C-16 

GH_RES_DATA system parameter, Sys Mgmt 
Util M-Z, C-16 

GH_RSRVPGCNT system parameter, Sys Mgmt 
Util M-Z, C-16 

GRANT/IDENTIFIER command 

in Authorize utility, Sys Mgmt Util A-L, 5-28 
Group number 

local area VMScluster, Sys Mgmt Util M-Z , 
6-15 

VMScluster 

displaying, Sys Mgmt Util M-Z , 6—17 
/GROUP qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-21 


access to service nodes, Sys Mgmt Util A-L, 
13-33, 13-51 

access to services in LAT environment, Sys 
Mgmt Util A-L, 13—29 
/GROUP_SIZE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-33 
GROWLIM system parameter, Sys Mgmt Util 
M-Z, C-17 

H__ _ 

HANGUP characteristic 

application LAT devices, Sys Mgmt Util A-L, 
13-10 
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/HDR3 qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-21 
Help 

online for Analyze Audit, Sys Mgmt Util A-L 
4-27 

HELP command 

in Audit Analysis utility, Sys Mgmt Util A-L 
4-27 

in Authorize utility, Sys Mgmt Util A-L, 5-30 
in CLUE, Sys Mgmt Util A-L, 8-8 
in Install utility, Sys Mgmt Util A-L, 11-11 
in LANCP utility, Sys Mgmt Util A-L, 12-16 
in LATCP, Sys Mgmt Util A-L, 13-22 
in Monitor utility, Sys Mgmt Util M-Z, 1-7 
in Show Cluster utility, Sys Mgmt Util M-Z 
4—36 

in SYSMAN, Sys Mgmt Util M-Z, 6-32 
HELP phase of AUTOGEN, Sys Mgmt Util A-L 
6-8 

History of installed software, Sys Mgmt Util M-Z 
3-20 

Holder Hidden attribute, Sys Mgmt Util A-L 
5-21, 5-29, 5-37 

Home blocks, Sys Mgmt Util A-L, 3-5 
/HOMEBLOCKS qualifier 

m Analyze/DiskjStructure utility, Sys Mgmt 
Util A-L , 3-8 


I 

I/O addresses, Sys Mgmt Util M-Z, 5-30 

I/O databases, Sys Mgmt Util M-Z, 5-27 

displaying on Alpha systems, Sys Mgmt Util 
M-Z , 6-40 
I/O drivers 

loading, Sys Mgmt Util M-Z, 5-14 
replacing with new version of, Sys Mgmt Util 
M-Z, 5-15 
I/O statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1-30 
ICBM 

See IOGEN Configuration Building Modules 
Identifier ACEs, Sys Mgmt Util A-L, 1-13 
types of identifiers, Sys Mgmt Util A-L, 1-13 
Identifiers 

default, Sys Mgmt Util A-L, 5-8 
environmental, Sys Mgmt Util A-L, 1-13 
general, Sys Mgmt Util A-L, 1-13, 1-16 
granting, Sys Mgmt Util A-L, 1-13, 5-28 
granting to a process, Sys Mgmt Util A-L, 1-15 
renaming, Sys Mgmt Util A-L, 5-45 
resource 

and directory ownership, Sys Mgmt Util 
A-L, 1-9 

revoking, Sys Mgmt Util A-L, 5-45 
specifying characteristics of, Sys Mgmt Util 
A-L, 1-16 


Identifiers (cont’d) 

specifying multiple pairs of, Sys Mgmt Util 
A-L, 1—16 

types, Sys Mgmt Util A-L, 1-13 
IEEE_ADDRESSH system parameter, Sys Mgmt 
Util M-Z, C-17 

IEEE_ADDRESS system parameter, Sys Mgmt 
Util M-Z, C-17 ® 

/IGNORE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-34 
IJOBLIM system parameter, Sys Mgmt Util M-Z 
C-17 
Image 


See also System loadable image 
accounting, Sys Mgmt Util A-L, 11-5 H_s 
11-19 

applying an ACE to, Sys Mgmt Util A-L, 1-15 
header-resident, Sys Mgmt Util A-L, 11-6 
11-8, 11-19 

privileged, Sys Mgmt Util A-L, 11-6, 11-9 
11-19 

protecting installed, Sys Mgmt Util A-L 11-7 
11-9, 11-19 
Image backup 

definition, Sys Mgmt Util A-L, 7-4 
Image mode, Sys Mgmt Util A-L, 7-35 
/IMAGE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-35 
IMGIOCNT system parameter, Sys Mgmt Util 
M-Z, C-53 

IMGREG_PAGES system parameter, Sys Mgmt 
Util M-Z, C-17 
/INCLUDE qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-22 
Incoming LAT connections, Sys Mgmt Util A-L 
13-27 

Incremental backup 

definition, Sys Mgmt Util A-L, 7-4 
Incremental mode 

restoring files, Sys Mgmt Util A-L, 7-37 
/INCREMENTAL qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-37 
Initialization 




Initialization files 

creating, Sys Mgmt Util M-Z, 4-48 
default specification, Sys Mgmt Util M-Z 6-4 
establish SHOW CLUSTER report, Sys Mgmt 
Util M-Z, 4-4 

use with SYSMAN, Sys Mgmt Util M-Z, 6-4 
Initialization procedures, Sys Mgmt Util A-L D-l 
/INITIALIZE=CONTINUATION qualifier 
in Mount utility, Sys Mgmt Util M-Z, 2-23 
INITIALIZE command 


in Monitor utility, Sys Mgmt Util M-Z, 1-8 
in Show Cluster utility, Sys Mgmt Util M-Z 
4-37 
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/INITIALIZE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-39 
INITIAL mode, Sys Mgmt Util A-L, 6-8 

Input files T a a 

security audit log files, Sys Mgmt Util A-L, 4-4 

/INPUT qualifier 

in Monitor utility, Sys Mgmt Util M-Z, l-ll 


Input stream 

switching control to other processes, Sys Mgmt 
Util M-Z, 6-13 
INSTALL command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-11 
in SYSGEN, Sys Mgmt Util M-Z, 5-13 
Installing software 

getting product information, Sys Mgmt Util 
M-Z, 3-20 

POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3—11 
removing software, Sys Mgmt Util M-Z, 3-19 
Install utility (INSTALL) 
commands 

ADD, Sys Mgmt Util A-L, 11-5 
CREATE, Sys Mgmt Util A-L, 11-8 
DELETE, Sys Mgmt Util A-L, 11-10 
EXIT, Sys Mgmt Util A-L, 11-11 
HELP, Sys Mgmt Util A-L, 11-11 
LIST, Sys Mgmt Util A-L, 11-12 
PURGE, Sys Mgmt Util A-L, 11-17 
REMOVE, Sys Mgmt Util A-L, 11-18 
REPLACE, Sys Mgmt Util A-L, 11-18 
exiting, Sys Mgmt Util A-L, 11-4 
invoking, Sys Mgmt Util A-L, 11-4 
Interactive commands 

See Command mode for Audit Analysis utility 
/INTERCHANGE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-40 
/INTERVAL qualifier, Sys Mgmt Util M-Z, 4-8 
in Monitor utility, Sys Mgmt Util M-Z, 1—11 
relationship of qualifier and event, Sys 
Mgmt Util M-Z, 1—12 

INTSTKPAGE S system parameter, Sys Mgmt 
Util M-Z, C-17 

Invoking ANALYZE/DISKJ3TRUCTURE, Sys 
Mgmt Util A-L, 3—6 

Invoking AUTOGEN, Sys Mgmt Util A-L, 6—10 
Invoking SYSGEN, Sys Mgmt Util M-Z, 5-4 
Invoking SYSMAN, Sys Mgmt Util M-Z, 6-5 
privilege requirements, Sys Mgmt Util M-Z, 
6-5 

10 AUTOCONFIGURE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-33 
10 CONNECT command 

in SYSMAN, Sys Mgmt Util M-Z, 6-34 


IOGEN Configuration Building Module, Sys 
Mgmt Util M-Z, 6—38, 6—39, 6—42 
10 LOAD command 

in SYSMAN, Sys Mgmt Util M-Z, 6-37 
10 SET EXCLUDE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-38 
10 SET PREFIX command 

in SYSMAN, Sys Mgmt Util M-Z, 6-39 
10 SHOW BUS command 

in SYSMAN, Sys Mgmt Util M-Z, 6-39 
10 SHOW DEVICE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-40 
10 SHOW EXCLUDE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-41 
10 SHOW PREFIX command 

in SYSMAN, Sys Mgmt Util M-Z, 6-42 
IOTA system parameter, Sys Mgmt Util M-Z, 
C-53 


J __ 

JOBCTLD system parameter, Sys Mgmt Util 

M-Z, C-17 
/JOURNAL qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-40 

K___ 

Keypad definitions, Sys Mgmt Util M-Z, 4-4, 4-53 

SHOW CLUSTER, Sys Mgmt Util M-Z, B-l 
Keypad editing 

editing commands, Sys Mgmt Util A-L , A-l 
for ACL editor, Sys Mgmt Util A-L, A-l 
LK201-specific editing commands, Sys Mgmt 
Util A-L , A-5 

Keys 

defining, Sys Mgmt Util M-Z , 6—19 
defining in LATCP, Sys Mgmt Util A-L, 13-17 
defining in SYSMAN, Sys Mgmt Util M-Z, 6-3 
displaying definition, Sys Mgmt Util M-Z, 6-57 
KFILSTCNT system parameter, Sys Mgmt Util 
M-Z, C-17 

Known file lists, Sys Mgmt Util A-L, 11-3 
Known images, Sys Mgmt Util A-L, 11-3 
adding, Sys Mgmt Util A-L, 11—5 
attributes of, Sys Mgmt Util A-L, 11—14 
creating, Sys Mgmt Util A-L, 11-8 
deleting, Sys Mgmt Util A-L, 11—10 
evaluating merits of installing, Sys Mgmt Util 
A-L, 11-13 

removing, Sys Mgmt Util A-L, 11—7, 11—18 
replacing, Sys Mgmt Util A-L, 11—18 
updating, Sys Mgmt Util A-L, 11—18 
KSTACKPAGES system parameter, Sys Mgmt 
Util M-Z, C-17 
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L 

/LABEL qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-42 
in Mount utility, Sys Mgmt Util M-Z, 2-23 
Labels 

disk, Sys Mgmt Util M-Z, 2-4 
disk volume set, Sys Mgmt Util M-Z, 2-5 
magnetic tape, Sys Mgmt Util M-Z, 2-4 
magnetic tape volume set, Sys Mgmt Util M-Z 
2-5 

LAMAPREGS system parameter, Sys Mgmt Util 
M-Z, C-18 

LANACP (Local Area Network Auxiliary Control 
Program) 

See LANACP LAN Server process 
LANACP LAN Server process, Sys Mgmt Util 
A-L, 12-3 

SET ACP command, Sys Mgmt Util A-L, 12-21 
LAN addresses, Sys Mgmt Util A-L, 13-7 
displaying, Sys Mgmt Util A-L, 13-51 
LAN controllers 

address, Sys Mgmt Util A-L, 13-51 
device name, Sys Mgmt Util A-L, 13-8 
physical address, Sys Mgmt Util A-L, 13-7 
LAN Control Program (LANCP) utility 

clearing counters, Sys Mgmt Util A-L, 12-9 
commands 

CLEAR DEVICE, Sys Mgmt Util A-L, 12-8 
CLEAR MOPDLL, Sys Mgmt Util A-L, 

12-9 

CLEAR NODE, Sys Mgmt Util A-L, 12-9 
CONNECT NODE, Sys Mgmt Util A-L 
12-10 

DEFINE DEVICE, Sys Mgmt Util A-L, 
12-11 

DEFINE NODE, Sys Mgmt Util A-L, 

12-13 

@ (Execute Procedure), Sys Mgmt Util A-L 
12-7 

EXIT, Sys Mgmt Util A-L, 12-16 
HELP, Sys Mgmt Util A-L, 12-16 
LIST DEVICE, Sys Mgmt Util A-L, 12-17 
LIST NODE, Sys Mgmt Util A-L, 12-18 
PURGE DEVICE, Sys Mgmt Util A-L 
12-20 

PURGE NODE, Sys Mgmt Util A-L, 12-20 
SET ACP, Sys Mgmt Util A-L, 12-21 
SET DEVICE, Sys Mgmt Util A-L, 12-22 
12-26 

SET NODE, Sys Mgmt Util A-L, 12-28 
SHOW CONFIGURATION, Sys Mgmt Util 
A-L, 12-31 

SHOW DEVICE, Sys Mgmt Util A-L, 

12-32 

SHOW LOG, Sys Mgmt Util A-L, 12-35 


LAN Control Program (LANCP) utility 
commands (cont’d) 

SHOW MOPDLL, Sys Mgmt Util A-L 
12-37 

SHOW NODE, Sys Mgmt Util A-L, 12-37 
SPAWN, Sys Mgmt Util A-L, 12-39 
TRIGGER NODE, Sys Mgmt Util A-L 
12-40 

UPDATE DEVICE, Sys Mgmt Util A-L 
12-41 

deleting device information, Sys Mgmt Util 
A-L, 12-8, 12-20 

deleting node information, Sys Mgmt Util A-L 
12-9, 12-20 

displaying node information, Sys Mgmt Util 
A-L, 12-18, 12-37 

displaying OPCOM messages, Sys Mgmt Util 
A-L, 12-21 

displaying status and counters, Sys Mgmt Util 
A-L, 12-18, 12-37 
exiting, Sys Mgmt Util A-L, 12-5 
invoking, Sys Mgmt Util A-L, 12-4 
MOP console carrier, Sys Mgmt Util A-L 
12-10 

MOP trigger boot, Sys Mgmt Util A-L, 12-40 
setting device information, Sys Mgmt Util A-L 
12-11 

LANCP (Local Area Network Control Program) 

See LAN Control Program (LANCP) utility 
LANs (local area networks) 

clearing counters, Sys Mgmt Util A-L, 12-9 
deleting device information, Sys Mgmt Util 
A-L, 12—8, 12—20 

deleting node information, Sys Mgmt Util A-L 
12-9, 12-20 

displaying LAN device parameters, Sys Mgmt 
Util A-L, 12-17, 12-32 

displaying node information, Sys Mgmt Util 
A-L, 12-18, 12-37 

displaying OPCOM messages, Sys Mgmt Util 
A-L, 12-21 

displaying status and counters, Sys Mgmt Util 
A-L, 12-18, 12-37 

LANCP SPAWN command, Sys Mgmt Util A-L 
12-39 

MOP console carrier, Sys Mgmt Util A-L 
12-10 

MOP trigger boot, Sys Mgmt Util A-L, 12-40 
setting device information, Sys Mgmt Util A-L 
12-11 

LAT$STARTUP.COM command procedure, Sys 
Mgmt Util A-L, 13-34 
LAT Control Program (LATCP) utility 
exiting, Sys Mgmt Util A-L, 13-22 
help, Sys Mgmt Util A-L, 13-22 
invoking, Sys Mgmt Util A-L, 13-4 
setting SCSSYSTEMID system parameter, Sys 
Mgmt Util A-L, 13-7 
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LATCP 

See LAT Control Program utility 
LAT software 

changing DECserver characteristics, Sys Mgmt 
Util A-L, 13-10, 13-35 
characteristics 

added or changed, Sys Mgmt Util A-L, 

13-4 

storing, Sys Mgmt Util A-L , 13—4 
connections, Sys Mgmt Util A-L , 13-32, 13-57 
incoming, Sys Mgmt Util A-L , 13—27 
outgoing, Sys Mgmt Util A-L , 13—27 
specifying type of, Sys Mgmt Util A-L, 

13-27 

devices 

changing HANGUP characteristic, Sys 
Mgmt Util A-L, 13-10 

device unit number, Sys Mgmt Util A-L, 13—33 
service 

creating, Sys Mgmt Util A-L , 13—14 
database, Sys Mgmt Util A-L , 13—30, 

13-33 

deleting, Sys Mgmt Util A-L , 13-21 
displaying characteristics of, Sys Mgmt 
Util A-L , 13-58 

displaying counters, Sys Mgmt Util A-L, 
13-57 

displaying information, Sys Mgmt Util 
A-L , 13-57 

identifier, Sys Mgmt Util A-L , 13—14, 
13-30, 13-39 

limiting size of node database, Sys Mgmt 
Util A-L , 13-30, 13-33 
modifying characteristics of, Sys Mgmt 
Util A-L , 13-39 

naming, Sys Mgmt Util A-L , 13—14, 13—26 
rating, Sys Mgmt Util A-L , 13-15, 13-40, 
13-51, 13-58 

session limit, Sys Mgmt Util A-L , 13-29, 13-31 
starting with SET NODE/STATE=ON, Sys 
Mgmt Util A-L , 13—32 

stopping with SET NODE/STATE=OFF, Sys 
Mgmt Util A-L, 13—32 
LGI system parameters 

LGI_BRK_DISUSER, Sys Mgmt Util M-Z, 
C-18 

LGI_BRK_LIM, Sys Mgmt Util M-Z, C-18 
LGI_BRK_TERM, Sys Mgmt Util M-Z, C-18 
LGI_BRK_TMO, Sys Mgmt Util M-Z, C-18 
LGI_CALLOUTS, Sys Mgmt Util M-Z, C-18 
LGI_HID_TIM, Sys Mgmt Util M-Z, C-18 
LGI_PWD_TMO, Sys Mgmt Util M-Z, C-18 
LGI_RETRY_LIM, Sys Mgmt Util M-Z, C-19 
LGI_RETRY_TMO, Sys Mgmt Util M-Z, C-19 
See also System parameters 
Login security 


LICENSE LOAD command 

in SYSMAN, Sys Mgmt Util M-Z, 6-43 
Licenses 

deactivating, Sys Mgmt Util M-Z, 6-43 
LICENSE UNLOAD command 

in SYSMAN, Sys Mgmt Util M-Z, 6-43 
Limited port, Sys Mgmt Util A-L, 13-11, 13-36 
Links 

creating with LATCP, Sys Mgmt Util A-L, 13-7 
deleting with LATCP, Sys Mgmt Util A-L, 
13-19 

displaying characteristics using LATCP, Sys 
Mgmt Util A-L , 13—45 

displaying counters using LATCP, Sys Mgmt 
Util A-L, 13-42 

displaying information using LATCP, Sys 
Mgmt Util A-L, 13—41 

modifying characteristics using LATCP, Sys 
Mgmt Util A-L, 13—26 

name options in LATCP, Sys Mgmt Util A-L, 


state of in LAT environment, Sys Mgmt Util 
A-L, 13-9 
LIST command 

in Audit Analysis utility, Sys Mgmt Util A-L, 

4- 28 

in Authorize utility, Sys Mgmt Util A-L, 5-31 
in Install utility, Sys Mgmt Util A-L, 11-12 
LIST DEVICE command 

in LANCP utility, Sys Mgmt Util A-L, 12-17 
LIST/IDENTIFIER command 

in Authorize utility, Sys Mgmt Util A-L, 5-33 
Listing 

network proxy database, Sys Mgmt Util A-L, 

5- 34 

rights database, Sys Mgmt Util A-L, 5-33, 

5—35 

system user authorization file (SYSUAF), Sys 
Mgmt Util A-L, 5-31 

Listing save-set information, Sys Mgmt Util A-L, 
7-18, 7-32, 7-44 
LIST NODE command 

in LANCP utility, Sys Mgmt Util A-L, 12-18 
LIST/PROXY command 

in Authorize utility, Sys Mgmt Util A-L, 5-34 
/LIST qualifier, Sys Mgmt Util A-L, 3-5 

in Analyze/Disk_Structure utility, Sys Mgmt 
Util A-L, 3-8 

in Backup utility, Sys Mgmt Util A-L, 7-44 
LIST/RIGHTS command 

in Authorize utility, Sys Mgmt Util A-L, 5-35 
LK201-specific editing commands, Sys Mgmt Util 
A-L, A-5 


LMCP 

See Log Manager Control Program (LMCP) 
utility 
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LNMPHASHTBL system parameter, Sys Mgmt 
Util M-Z, C-19 

LNMSHASHTBL system parameter, Sys Mgmt 
Util M-Z, C-19 

Load balancing, Sys Mgmt Util A-L, 13-15, 13-40 
and CPU power, Sys Mgmt Util A-L, 13-28 
LOAD command 

in SYSGEN, Sys Mgmt Util M-Z, 5-14 
Loading device drivers 

on Alpha systems, Sys Mgmt Util M-Z, 6-33 
6-34, 6-37 

Loading I/O driver, Sys Mgmt Util M-Z, 5-14 
Load/start MSCP server, Sys Mgmt Util M-Z 
5—14 

LOAD_PWD_POLICY system parameter, Sys 
Mgmt Util M-Z, C-19 

LOAD_SYS_IMAGES system parameter, Sys 
Mgmt Util M-Z, C-19 
Local area VMScluster environments 

setting system date and time, Sys Mgmt Util 
M-Z, 6-16 

LOCAL.PORTS class 

adding, Sys Mgmt Util M-Z, 4-28 
fields belonging to, Sys Mgmt Util M-Z, 4-23 
removing, Sys Mgmt Util M-Z, 4-45 
LOCK class record 

in Monitor utility, Sys Mgmt Util M-Z, A-22 
LOCKDIRWT system parameter, Sys Mgmt Util 
M-Z, C-20 

LOCKIDTBL system parameter, Sys Mgmt Util 
M-Z, C-20 

LOCKIDTBL_MAX system parameter, Sys Mgmt 
Util M-Z, C-20 

LOCKRETRY system parameter, Sys Mgmt Util 
M-Z, C-53 
Logical names 

with MOUNT, Sys Mgmt Util M-Z, 2-5 
Login command procedures 

LOGIN.COM, Sys Mgmt Util A-L, 5-28 
Log Manager Control Program (LMCP) utility, 

Sys Mgmt Util A-L, 14-1 
CLOSE LOG command, Sys Mgmt Util A-L 
14-5 

CONVERT LOG command, Sys Mgmt Util A-L 
14-5 

CREATE LOG command, Sys Mgmt Util A-L 
14-7 

DUMP command, Sys Mgmt Util A-L, 14-8 
HELP command, Sys Mgmt Util A-L, 14-12 
REPAIR commands, Sys Mgmt Util A-L, 14-13 
COMMIT, Sys Mgmt Util A-L, 14-15 
EXIT, Sys Mgmt Util A-L, 14-15 
FORGET, Sys Mgmt Util A-L, 14-15 
NEXT, Sys Mgmt Util A-L, 14-15 
SHOW LOG command, Sys Mgmt Util A-L 
14-16 


Log Manager Control Program (LMCP)utility 
REPAIR commands 

ABORT, Sys Mgmt Util A-L, 14-15 
/LOG qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-45 
LONGWAIT system parameter, Sys Mgmt Util 
M-Z, C-20 
Lost files 

recovering, Sys Mgmt Util A-L, 3-4 
LPBEGIN phase of system startup, Sys Mgmt 
Util M-Z, 6-71 

LPBETA phase of system startup, Sys Mgmt Util 
M-Z, 6-71 

LPMAIN phase of system startup, Sys Mgmt Util 
M-Z, 6-71 

LTA device, Sys Mgmt Util A-L, 13-28 
LTDRIVER (LAT port driver) 

turning on and off, Sys Mgmt Util A-L, 13-3 

M 

Magnetic tape devices 

serving within a cluster, Sys Mgmt Util M-Z 
C-42 

Magnetic tapes 

mounting, Sys Mgmt Util M-Z, 2-4 
mounting ANSI-labeled, Sys Mgmt Util M-Z 
2-21, 2-23 

mounting multiple foreign volumes, Sys Mgmt 
Util M-Z, 2-26 

overriding protection checks, Sys Mgmt Util 
M-Z, 2-27 

specifying block size for, Sys Mgmt Util M-Z 
2-11 

specifying density for, Sys Mgmt Util M-Z 
2-19 

specifying record size for, Sys Mgmt Util M-Z 
2-33 

Management environment 

defining, Sys Mgmt Util M-Z, 6-53 
MAXBUF system parameter, Sys Mgmt Util M-Z 
C-20 

MAXCLASSPRI system parameter, Sys Mgmt 
Util M-Z, C-53 

MAXPROCESSCNT system parameter, Sys Mgmt 
Util M-Z, C-21 

MAXQUEPRI system parameter, Sys Mgmt Util 
M-Z, C-21 

MAXSYSGROUP system parameter, Sys Mgmt 
Util M-Z, C-21 
MCR command 

in SYSMAN, Sys Mgmt Util M-Z, 6-5, 6-30 
/MEDIA_FORMAT=CD-ROM qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-24 
/MEDIA_FORMAT=[NO]COMPACTION qualifier 
in Mount utility, Sys Mgmt Util M-Z, 2-24 
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/MEDIA_FORMAT qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-46 
MEMBERS class 

adding, Sys Mgmt Util M-Z, 4-30 
fields belonging to, Sys Mgmt Util M-Z, 4-25 
removing, Sys Mgmt Util M-Z, 4 46 
Memory 

multiport, Sys Mgmt Util M-Z, 5—17 
/MESSAGE qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-25 
MINCLASSPRI system parameter, Sys Mgmt Util 
M-Z, C-53 

MINWSCNT system parameter, Sys Mgmt Util 
M-Z, C-21 

MMG_CTLFLAGS system parameter, Sys Mgmt 
Util M-Z, C-21 
MODES class record 

in Monitor utility, Sys Mgmt Util M-Z, A-23 
Modes of execution, Sys Mgmt Util A-L, 6-8 

for SYSMAN startup files, Sys Mgmt Util M-Z, 
6-66 

Modes of operation, Sys Mgmt Util A-L, 3-3 
image, Sys Mgmt Util A-L, 7—35 
physical, Sys Mgmt Util A-L, 7—49 
/MODIFIED qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-47 
MODIFY command 

in Authorize utility, Sys Mgmt Util A-L, 5-36 
MODIFY/IDENTIFIER command 

in Authorize utility, Sys Mgmt Util A-L, 5-37 
Modifying page, swap, and dump file sizes, Sys 
Mgmt Util A-L, 6—3 
Modifying system parameters 

recommended method, Sys Mgmt Util A-L, 6—3 
MODIFY/PROXY command 

in Authorize utility, Sys Mgmt Util A-L, 5-39 
MODIFY/SYSTEM_PASSWORD command 

in Authorize utility, Sys Mgmt Util A-L, 5-40 
MONITOR ALL_CLASSES command 

in Monitor utility, Sys Mgmt Util M-Z, 1-14 
MONITOR CLUSTER command 

in Monitor utility, Sys Mgmt Util M-Z, 1—15 
MONITOR command 

in Monitor utility, Sys Mgmt Util M-Z, 1-8 
MONITOR DECNET command 

in Monitor utility, Sys Mgmt Util M-Z, 1-19 
MONITOR DISK command 

in Monitor utility, Sys Mgmt Util M-Z, 1-20 
MONITOR DLOCK command 

in Monitor utility, Sys Mgmt Util M-Z, 1-23 
MONITOR FCP command 

in Monitor utility, Sys Mgmt Util M-Z, 1-25 
MONITOR FILE_SYSTEM_CACHE command 
in Monitor utility, Sys Mgmt Util M-Z, 1-26 
MONITOR 10 command 

in Monitor utility, Sys Mgmt Util M-Z, 1-30 


MONITOR LOCK command 

in Monitor utility, Sys Mgmt Util M-Z, 1-32 
MONITOR MODES command 

in Monitor utility, Sys Mgmt Util M-Z, 1-33 
MONITOR MSCP_SERVER command 

in Monitor utility, Sys Mgmt Util M-Z, 1-36 
MONITOR PAGE command 

in Monitor utility, Sys Mgmt Util M-Z, 1-38 
MONITOR PROCESSES command 

in Monitor utility, Sys Mgmt Util M-Z, 1-40 
MONITOR RMS command 

in Monitor utility, Sys Mgmt Util M-Z, 1-43 
MONITOR SCS command 

in Monitor utility, Sys Mgmt Util M-Z, 1-46 
MONITOR STATES command 

in Monitor utility, Sys Mgmt Util M-Z, 1-49 
MONITOR SYSTEM command 

in Monitor utility, Sys Mgmt Util M-Z, 1-52 
MONITOR TRANSACTION command 

in Monitor utility, Sys Mgmt Util M-Z, 1-55 
Monitor utility (MONITOR) 
class-name qualifiers 

/ALL, Sys Mgmt Util M-Z, 1-14 
/AVERAGE, Sys Mgmt Util M-Z, 1-14 
/CPU, Sys Mgmt Util M-Z, 1-34 
/CURRENT, Sys Mgmt Util M-Z, 1-14 
/ITEM, Sys Mgmt Util M-Z, 1-21, 1-47 
/MAXIMUM, Sys Mgmt Util M-Z, 1-14 
/MINIMUM, Sys Mgmt Util M-Z, 1-14 
/PERCENT, Sys Mgmt Util M-Z, 1-21 
/TOPBIO, Sys Mgmt Util M-Z, 1-40 
/TOPCPU, Sys Mgmt Util M-Z, 1-40 
/TOPDIO, Sys Mgmt Util M-Z, 1-40 
/TOPFAULT, Sys Mgmt Util M-Z, 1-40 
/TOPRBS, Sys Mgmt Util M-Z, 1-41 
Cluster performance statistics, Sys Mgmt Util 
M-Z, 1-15 

collection interval, Sys Mgmt Util M-Z, 1-11 
command qualifiers, Sys Mgmt Util M-Z, 1-9 
to 1-14 

commands, Sys Mgmt Util M-Z, 1—5 to 1—61 
CONVERT, Sys Mgmt Util M-Z, 1-5 
EXECUTE, Sys Mgmt Util M-Z, 1-6 
EXIT, Sys Mgmt Util M-Z, 1-7 
HELP, Sys Mgmt Util M-Z, 1-7 
INITIALIZE, Sys Mgmt Util M-Z, 1-8 
MONITOR, Sys Mgmt Util M-Z, 1-8 
MONITOR ALL_CLASSES, Sys Mgmt Util 
M-Z, 1-14 

MONITOR CLUSTER, Sys Mgmt Util 
M-Z, 1-15 

MONITOR DECNET, Sys Mgmt Util M-Z, 
1-19 

MONITOR DISK, Sys Mgmt Util M-Z, 
1-20 

MONITOR DLOCK, Sys Mgmt Util M-Z, 
1—23 

MONITOR FCP, Sys Mgmt Util M-Z, 1-25 
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Monitor utility (MONITOR) 
commands (cont’d) 

MONITOR FILE_SYSTEM_CACHE, Sys 
Mgmt Util M-Z, 1-26 
MONITOR 10, Sys Mgmt Util M-Z, 1-30 
MONITOR LOCK, Sys Mgmt Util M-Z 
1-32 

MONITOR MODES, Sys Mgmt Util M-Z 
1-33 

MONITOR MSCP_SERVER, Sys Mgmt 
Util M-Z, 1-36 

MONITOR PAGE, Sys Mgmt Util M-Z, 
1-38 

MONITOR PROCESSES, Sys Mgmt Util 
M-Z, 1-40 

MONITOR RMS, Sys Mgmt Util M-Z, 1-43 
MONITOR SCS, Sys Mgmt Util M-Z, 1-46 
MONITOR STATES, Sys Mgmt Util M-Z 
1-49 

MONITOR SYSTEM, Sys Mgmt Util M-Z 
1-52 

MONITOR TRANSACTION, Sys Mgmt 
Util M-Z, 1-55 

SET DEFAULT, Sys Mgmt Util M-Z, 1-60 
SHOW DEFAULT, Sys Mgmt Util M-Z, 
1-61 

directing output, Sys Mgmt Util M-Z, 1-4 
exiting, Sys Mgmt Util M-Z, 1-4 
invoking, Sys Mgmt Util M-Z, 1-4 
recording file record formats, Sys Mgmt Util 
M-Z, A-l to A-13 

relationship of qualifier and event, Sys Mgmt 
Util M-Z, 1-12 

MONITOR VECTOR command, Sys Mgmt Util 
M-Z, 1-58 

MONITOR_SERVER process 

log file, Sys Mgmt Util M-Z, 1-17 
network startup, Sys Mgmt Util M-Z, 1-17 
purpose, Sys Mgmt Util M-Z, 1-17 
startup time, Sys Mgmt Util M-Z, 1-18 
MOP downline load service 

clearing counters, Sys Mgmt Util A-L, 12-9 
console carrier, Sys Mgmt Util A-L, 12-10 
displaying status and counters, Sys Mgmt Util 
A-L, 12-18, 12-37 

trigger boot, Sys Mgmt Util A-L, 12-40 
MOUNT command 

avoiding use of /CLUSTER with SYSMAN DO 
command, Sys Mgmt Util M-Z, 6-31 
Mount error message, Sys Mgmt Util A-L, 7-56 
Mount utility (MOUNT) 

directing output, Sys Mgmt Util M-Z, 2-6 
examples 

allocating file window mapping pointers, 

Sys Mgmt Util M-Z , 2-39 
creating a volume set, Sys Mgmt Util M-Z 
2-11 


Mount utility (MOUNT) 
examples (cont’d) 

disabling automatic rebuild, Sys Mgmt 
Util M-Z , 2-33 

enabling access to subsystems, Sys Mgmt 
Util M-Z , 2-35 

making a volume public, Sys Mgmt Util 
M-Z , 2-36 

mounting an ANSI-labeled magnetic tape, 
Sys Mgmt Util M-Z , 2-21, 2-23 
mounting a volume clusterwide, Sys Mgmt 
Util M-Z , 2-14 

overriding volume protection checks, Sys 
Mgmt Util M-Z , 2-29 
rebuilding a disk volume, Sys Mgmt Util 
M-Z , 2-33 

requesting operator assistance, Sys Mgmt 
Util M-Z , 2-9, 2-41 

specifying a protection code, Sys Mgmt 
Util M-Z , 2-31 

specifying a shareable volume, Sys Mgmt 
Util M-Z , 2-35 

specifying block size for magnetic tape, Sys 
Mgmt Util M-Z , 2-12 
specifying default block extent, Sys Mgmt 
Util M-Z , 2-20 

specifying magnetic tape density, Sys 
Mgmt Util M-Z , 2-19 
specifying magnetic tape record size, Sys 
Mgmt Util M-Z , 2-34 

specifying number of directories, Sys Mgmt 
Util M-Z , 2-8 

exiting, Sys Mgmt Util M-Z , 2-6 
invoking, Sys Mgmt Util M-Z , 2-6 
multiple foreign tape volumes, Sys Mgmt Util 
M-Z , 2-26 

overriding volume protection checks, Sys Mgmt 
Util M-Z , 2-27 

parameters, Sys Mgmt Util M-Z , 2-4 
qualifiers 

/ACCESSED, Sys Mgmt Util M-Z , 2—8 
/ASSIST, Sys Mgmt Util M-Z , 2-8 
/AUTOMATIC, Sys Mgmt Util M-Z , 2-9 
/BIND, Sys Mgmt Util M-Z , 2-10 
/BLOCKSIZE, Sys Mgmt Util M-Z , 2-11 
/CACHE, Sys Mgmt Util M-Z , 2-12 
/CLUSTER, Sys Mgmt Util M-Z , 2-14 
/COMMENT, Sys Mgmt Util M-Z , 2-15 
/CONFIRM, Sys Mgmt Util M-Z , 2-16 
/COPY, Sys Mgmt Util M-Z , 2-17 
/DATA_CHECK, Sys Mgmt Util M-Z , 2-18 
/DENSITY, Sys Mgmt Util M-Z , 2-19 
/EXTENSION, Sys Mgmt Util M-Z , 2-19 
/FOREIGN, Sys Mgmt Util M-Z , 2-20 
/GROUP, Sys Mgmt Util M-Z , 2-21 
/HDR3, Sys Mgmt Util M-Z , 2-21 
/INCLUDE, Sys Mgmt Util M-Z , 2-22 
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Mount utility (MOUNT) 
qualifiers (cont’d) 

/INITIALIZE=CONTINUATION, Sys 
Mgmt Util M-Z, 2—23 
/LABEL, Sys Mgmt Util M-Z, 2-23 
/MEDIA_FORMAT=CD-ROM, Sys Mgmt 
Util M-Z, 2-24 

/MEDIA_FORMAT=[N OICOMPACTION, 

Sys Mgmt Util M-Z, 2-24 
/MESSAGE, Sys Mgmt Util M-Z, 2-25 
/MOUNT_VERIFICATION, Sys Mgmt Util 
M-Z, 2-26 

/MULTIJVOLUME, Sys Mgmt Util M-Z, 

2-26 

/OVERRIDE, Sys Mgmt Util M-Z, 2-27 
/OWNER_UIC, Sys Mgmt Util M-Z, 2-29 
/PROCESSOR, Sys Mgmt Util M-Z, 2-30 
/PROTECTION, Sys Mgmt Util M-Z, 2-31 
/QUOTA, Sys Mgmt Util M-Z, 2-32 
/REBUILD, Sys Mgmt Util M-Z, 2-32 
/RECORDSIZE, Sys Mgmt Util M-Z, 2-33 
/SHADOW, Sys Mgmt Util M-Z, 2-34 
/SHARE, Sys Mgmt Util M-Z, 2-35 
/SUBSYSTEM, Sys Mgmt Util M-Z, 2-35 
/SYSTEM, Sys Mgmt Util M-Z, 2-36 
/UCS_SEQUENCE=(ESCAPE_ 

SEQUENCE), Sys Mgmt Util M-Z, 

2-36 

/UNDEFINED_FAT, Sys Mgmt Util M-Z, 
2—37 

/UNLOAD, Sys Mgmt Util M-Z, 2-38 
/WINDOWS, Sys Mgmt Util M-Z, 2-39 
/WRITE, Sys Mgmt Util M-Z, 2-39 
requesting an ancillary control process (ACP), 
Sys Mgmt Util M-Z, 2-30 
restrictions, Sys Mgmt Util M-Z, 2-6 
specifying a user identification code (UIC), Sys 
Mgmt Util M-Z, 2—29 

specifying write protection, Sys Mgmt Util 
M-Z, 2-39 

/MOUNT_VERIFICATION qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-26 
MOVE command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-37 

MOVE keypad function, Sys Mgmt Util M-Z, B-3 
MPW_HILIMIT system parameter, Sys Mgmt 
Util M-Z, C-22 

MPW_IOLIMIT system parameter, Sys Mgmt Util 
M-Z, C-22 

MPW_LOLIMIT system parameter, Sys Mgmt 
Util M-Z, C-22 

MPW_LOWAITLIMIT system parameter, Sys 
Mgmt Util M-Z, C—22 

MPW_PRIO system parameter, Sys Mgmt Util 
M-Z, C-53 


MPW_THRESH system parameter, Sys Mgmt 
Util M-Z, C-22 

MPW_WAITLIMIT system parameter, Sys Mgmt 
Util M-Z, C-23 

MPW_WRTCLUSTER system parameter, Sys 
Mgmt Util M-Z, C—23 
MSCP command 

in SYSGEN, Sys Mgmt Util M-Z, 5-14 
MSCP servers 

loading, Sys Mgmt Util M-Z, 5—14 
starting, Sys Mgmt Util M-Z, 5-14 
MSCP_BUFFER system parameter, Sys Mgmt 
Util M-Z, C-23 

MSCP_CREDITS system parameter, Sys Mgmt 
Util M-Z, C-23 

MSCP_LOAD system parameter, Sys Mgmt Util 
M-Z, C-23 

MSCP_SERVER class record 

in Monitor utility, Sys Mgmt Util M-Z, A-25 
MSCP_SERVE_ALL system parameter, Sys Mgmt 
Util M-Z, C-24 
Multicast address 
VMScluster 

displaying, Sys Mgmt Util M-Z, 6-17 
Multicast messages, Sys Mgmt Util A-L, 13-22, 
13-42 

timer for, Sys Mgmt Util A-L, 13—30 
Multiport memory 

connecting, Sys Mgmt Util M-Z, 5—17 
initializing, Sys Mgmt Util M-Z, 5—18 
sharing, Sys Mgmt Util M-Z, 5—17 
MULTIPROCESSING system parameter, Sys 
Mgmt Util M-Z, C-24 
/MULTI_VOLUME qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2—26 
MVTIMEOUT system parameter, Sys Mgmt Util 
M-Z, C-25 

N__ 

Name Hidden attribute, Sys Mgmt Util A-L, 5-21, 
5-29, 5-37 

NET$PROXY.DAT file 

description of, Sys Mgmt Util A-L, 5—3 
NETPROXY.DAT files 

creating, Sys Mgmt Util A-L, 5—25 
description of, Sys Mgmt Util A-L, 5—3 
displaying proxy access, Sys Mgmt Util A-L, 
5-52 

modifying, Sys Mgmt Util A-L, 5—3 
Network proxy authorization files 
creating, Sys Mgmt Util A-L, 5—25 
for Alpha and VAX, Sys Mgmt Util A-L, 5-3 
modifying, Sys Mgmt Util A-L, 5—3 
Network statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1—19 
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NET_CALLOUTS system parameter, Sys Mgmt 
Util M-Z, C-25 
/NEW_VERSION qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-47 
NEXT FILE command 

in Audit Analysis utility, Sys Mgmt Util A-L 

4-28 

NEXT RECORD command 

in Audit Analysis utility, Sys Mgmt Util A-L 
4-29 

Nexus numbers 

showing, Sys Mgmt Util M-Z, 5-23, 5-24, 5-29 
NISCS_CONV_BOOT system parameter, Sys 
Mgmt Util M-Z, C-25 

NISCS_LAN_OVRHD system parameter, Sys 
Mgmt Util M-Z, C-25 

NISCS_LOAD_PEAO system parameter, Sys 
Mgmt Util M-Z, C-25 

NISCS_MAX_PKTSZ system parameter, Sys 
Mgmt Util M-Z, C-25 

NISCS_PORT_SERV system parameter, Sys 
Mgmt Util M-Z, C-26 

NJOBLIM system parameter, Sys Mgmt Util 
M-Z, C-26 

No Access attribute, Sys Mgmt Util A-L, 5-21 

5-29, 5-37 

NOAUTOCONFIG system parameter, Sys Mgmt 
Util M-Z, C-53 

NOCLUSTER system parameter, Sys Mgmt Util 
M-Z, C-53 

Node names, Sys Mgmt Util A-L, 13-27 
Node numbers 

display on Alpha systems, Sys Mgmt Util M-Z 

6-39 

/NODE qualifier 

in Monitor utility, Sys Mgmt Util M-Z, 1-12 
Nodes 

database, Sys Mgmt Util A-L, 13-30, 13-33 
deleting node information, Sys Mgmt Util A-L 
12-9, 12-20 

displaying characteristics of, Sys Mgmt Util 
A-L, 13-50 

displaying counters, Sys Mgmt Util A-L, 13-47 
displaying information using LATCP, Sys 
Mgmt Util A-L, 13-46 
limit, Sys Mgmt Util A-L, 13-30 
modifying characteristics of, Sys Mgmt Util 
A-L, 13-27 

state, Sys Mgmt Util A-L, 13-32 
target, Sys Mgmt Util A-L, 13-54 
NOFEEDBACK mode, Sys Mgmt Util A-L, 6-8 
NOPGSWP system parameter, Sys Mgmt Util 
M-Z, C-53 

/[NOICONFIRM qualifier 

in Analyze/Disk_Structure utility, Sys Mgmt 
Util A-L, 3-7 


/[NOJLIST qualifier 

in Analyze/Disk_Structure utility, Sys Mgmt 
Util A-L, 3-8 
/[NOJOUTPUT qualifier 

in Analyze/Disk_Structure utility, Sys Mgmt 
Util A-L, 3-9 

/[NO]READ_CHECK qualifier 

in Analyze/DiskjStructure utility, Sys Mgmt 
Util A-L, 3-9 
/[NOJREPAIR qualifier 

in Analyze/Disk_Structure utility, Sys Mgmt 
Util A-L, 3-11 

NPAGEDYN system parameter, Sys Mgmt Util 
M-Z, C-26 

NPAGEVIR system parameter, Sys Mgmt Util 
M-Z, C-26 

o 

Object classes 

security class object, Sys Mgmt Util A-L, 1-4 
Objects 

controlling access to, Sys Mgmt Util A-L, 1-13 
Object types 

See Object classes 
OPCOM 
messages 

generated by LANACP, Sys Mgmt Util 
A-L, 12-21 

Open VMS Backup utility 

See Backup utility (BACKUP) 

OpenVMS RMS 
See RMS 
Operations 

compare, Sys Mgmt Util A-L, 7-23 
list, Sys Mgmt Util A-L, 7-18, 7-32, 7-44 
performed by BACKUP, Sys Mgmt Util A-L 

7-3 

Operator assistance 

with BACKUP, Sys Mgmt Util A-L, 7-15 
Outgoing LAT connections, Sys Mgmt Util A-L 
13-27 

Outgoing port 

displaying, Sys Mgmt Util A-L, 13-53 
Output, Sys Mgmt Util A-L, 3-6 

directing, Sys Mgmt Util A-L, 3-5; Sys Mgmt 
Util M-Z, 4-55 

directing Show Cluster, Sys Mgmt Util M-Z 

4- 5, 4-8 

directing SYSGEN, Sys Mgmt Util M-Z, 5-3 

5- 7, 5-16, 5-24 

specifying file, Sys Mgmt Util M-Z, 4-5, 4-8 
4-55, 5-7, 5-16 
Output messages 

volume mount, Sys Mgmt Util M-Z, 2-3, 2-25 
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/OUTPUT qualifier, Sys Mgmt Util M-Z, 4-8 
in Analyze/Disk_Structure utility, Sys Mgmt 
Util A-L, 3-9 

in Monitor utility, Sys Mgmt Util M-Z, 1-13 
/OVERLAY qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-48 
/OVERRIDE qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-27 
/OWNER_UIC qualifier 

as Backup utility input file qualifier, Sys Mgmt 
Util A-L, 7-49 

in Mount utility, Sys Mgmt Util M-Z, 2-29 

P__ 

PACKAGE command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-13 

/PAGE=SAVE qualifier navigation keys, Sys Mgmt 
Util A-L, 5-47 
PAGE class record 

in Monitor utility, Sys Mgmt Util M-Z, A-27 
PAGEDYN system parameter, Sys Mgmt Util 
M-Z, C-26 
PAGEFILE.SYS file 
See Page files 
Page files 

changing size, Sys Mgmt Util A-L, 6-3 
displaying the size calculated by AUTOGEN, 

Sys Mgmt Util A-L, 6—7 

generating a new file sized by AUTOGEN, Sys 
Mgmt Util A-L, 6—7 
Page management statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1-38 
PAGFILCNT system parameter, Sys Mgmt Util 
M-Z, C-26 

PAGTBLPFC system parameter, Sys Mgmt Util 
M-Z, C-53 

PAMAXPORT system parameter, Sys Mgmt Util 
M-Z, C-26 
PAN command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-39 

PAN keypad function, Sys Mgmt Util M-Z, B-3 
PANOPOLL system parameter, Sys Mgmt Util 
M-Z, C-27 

PANUMPOLL system parameter, Sys Mgmt Util 
M-Z, C-27 

PA PO T ,T .IN TERVAL system parameter, Sys Mgmt 
Util M-Z, C-27 

PAPOOLINTERVAL system parameter, Sys Mgmt 
Util M-Z, C-27 
Parameter files 

ALPHAVMSSYS.OLD, Sys Mgmt Util A-L, 6-7 
ALPHAVMSSYS.PAR, Sys Mgmt Util A-L, 6-7 
AUTOGEN.PAR, Sys Mgmt Util A-L, 6-7 
default, Sys Mgmt Util A-L, 6-7 
VAXVMSSYS.OLD, Sys Mgmt Util A-L, 6-7 


Parameter files (cont’d) 

VAXVMSSYS.PAR, Sys Mgmt Util A-L, 6-7 
writing, Sys Mgmt Util M-Z, 5-33, 6-51 
Parameters, Sys Mgmt Util M-Z, 2—4 
See also System parameters 
changing, Sys Mgmt Util M-Z, 6-46 
passing to command procedures, Sys Mgmt 
Util A-L, 12-7 

PARAMETERS DISABLE CHECKS command 
in SYSMAN, Sys Mgmt Util M-Z, 6-44 
PARAMETERS ENABLE CHECKS command 
in SYSMAN, Sys Mgmt Util M-Z, 6-45 
PARAMETERS SET command 

in SYSMAN, Sys Mgmt Util M-Z, 6-46 
PARAMETERS SHOW command 

in SYSMAN, Sys Mgmt Util M-Z, 6-47 
PARAMETERS USE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-50 
PARAMETERS WRITE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-51 
PARAMS.DAT file, Sys Mgmt Util A-L, 6-6, 6-7 
PASANITY system parameter, Sys Mgmt Util 
M-Z, C-28 

Password, Sys Mgmt Util M-Z, 6—53 

for local area VMScluster, Sys Mgmt Util M-Z, 
6-15 

PASTDGBUF system parameter, Sys Mgmt Util 
M-Z, C-28 

Paste buffers, Sys Mgmt Util A-L, A—5 
PASTIMOUT system parameter, Sys Mgmt Util 
M-Z, C-28 

PCFs (product configuration files) 

CONFIGURE subcommand, Sys Mgmt Util 
M-Z, 3-5 

PDB (product database) 

recording a volume label change, Sys Mgmt 
Util M-Z, 3-18 

PE system parameter, Sys Mgmt Util M-Z, C-53 
PFCDEFAULT system parameter, Sys Mgmt Util 
M-Z, C-28 

PFN_COLOR_COUNT system parameter, Sys 
Mgmt Util M-Z, C-54 

PFRATH system parameter, Sys Mgmt Util M-Z, 
C-28 

PFRATL system parameter, Sys Mgmt Util M-Z, 
C-29 

PFRATS system parameter, Sys Mgmt Util M-Z, 
C-54 

Phases of AUTOGEN, Sys Mgmt Util A-L, 6-5 
Physical mode, Sys Mgmt Util A-L, 7-49 
PHYSICALPAGES system parameter, Sys Mgmt 
Util M-Z, C-54 
/PHYSICAL qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-49 
PHYSICAL_MEMORY system parameter, Sys 
Mgmt Util M-Z, C-54 
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PIOPAGES system parameter, Sys Mgmt Util 
M-Z, C-54 

PIXSCAN system parameter, Sys Mgmt Util M-Z, 
C—54 

POLYCENTER Software Installation utility 
(PRODUCT), Sys Mgmt Util M-Z, 3-3 
See also PRODUCT command 
commands 

CONFIGURE, Sys Mgmt Util M-Z, 3-5 
COPY, Sys Mgmt Util M-Z, 3-7 
EXTRACT RELEASE_NOTES, Sys Mgmt 
Util M-Z, 3-9 

FIND, Sys Mgmt Util M-Z, 3-10 
INSTALL, Sys Mgmt Util M-Z, 3-11 
PACKAGE, Sys Mgmt Util M-Z, 3-13 
RECONFIGURE, Sys Mgmt Util M-Z 
3-14 

REGISTER PRODUCT, Sys Mgmt Util 
M-Z, 3—16 

REGISTER VOLUME, Sys Mgmt Util 
M-Z, 3-18 

REMOVE, Sys Mgmt Util M-Z, 3-19 
SHOW HISTORY, Sys Mgmt Util M-Z 
3-20 

SHOW OBJECT, Sys Mgmt Util M-Z, 3-22 
SHOW PRODUCT, Sys Mgmt Util M-Z 
3-24 

invoking, Sys Mgmt Util M-Z, 3-4 
parameters, Sys Mgmt Util M-Z, 3-4 
POOLCHECK system parameter, Sys Mgmt Util 
M-Z, C-54 

POOLPAGING system parameter, Sys Mgmt Util 
M-Z, C-55 
Ports 

application, Sys Mgmt Util A-L, 13-10, 13-35 
13-37, 13-52 

characteristics, Sys Mgmt Util A-L, 13-52 • 
counters, Sys Mgmt Util A-L, 13-52 
creating with LATCP, Sys Mgmt Util A-L, 13-9 
dedicated, Sys Mgmt Util A-L, 13-10, 13-36 
13-52 

deleting with LATCP, Sys Mgmt Util A-L 
13-20 

displaying characteristics of, Sys Mgmt Util 
A-L, 13-53 

displaying information using LATCP, Sys 
Mgmt Util A-L, 13-52 
limited, Sys Mgmt Util A-L, 13-11, 13-36 
logical name of, Sys Mgmt Util A-L, 13-11 
modifying characteristics of with LATCP, Sys 
Mgmt Util A-L, 13-35 
name, Sys Mgmt Util A-L, 13-35 
outgoing connection, Sys Mgmt Util A-L, 13-53 
setting type of, Sys Mgmt Util A-L, 13-10 
target, Sys Mgmt Util A-L, 13-54 
POSITION command 

in Audit Analysis utility, Sys Mgmt Util A-L 
4-29 


PQL system parameters 

PQL_DASTLM, Sys Mgmt Util M-Z, C-29 
PQL_DBIOLM, Sys Mgmt Util M-Z, C-29 
PQL_DBYTLM, Sys Mgmt Util M-Z, C-29 
PQL_DCPULM, Sys Mgmt Util M-Z, C-29 
PQL-DDIOLM, Sys Mgmt Util M-Z, C-29 
PQL_DENQLM, Sys Mgmt Util M-Z, C-29 
PQL_DFILLM, Sys Mgmt Util M-Z, C-29 
PQL_DJTQUOTA, Sys Mgmt Util M-Z, C-29 
PQL_DPGFLQUOTA, Sys Mgmt Util M-Z 
C-30 

PQL_DPRCLM, Sys Mgmt Util M-Z, C-30 
PQL_DTQELM, Sys Mgmt Util M-Z, C-30 
PQL_DWSDEFAULT, Sys Mgmt Util M-Z 
C-30 

PQL.DWSEXTENT, Sys Mgmt Util M-Z, C-30 
PQL_DWSQUOTA, Sys Mgmt Util M-Z, C-30 
PQL_MASTLM, Sys Mgmt Util M-Z, C-30 
PQL_MBIOLM, Sys Mgmt Util M-Z, C-30 
PQL_MBYTLM, Sys Mgmt Util M-Z, C-30 
PQL_MCPULM, Sys Mgmt Util M-Z, C-30 
PQL_MDIOLM, Sys Mgmt Util M-Z, C-30 
PQL_MENQLM, Sys Mgmt Util M-Z, C-30 
PQL_MFILLM, Sys Mgmt Util M-Z, C-31 
PQL_MJTQUOTA, Sys Mgmt Util M-Z, C-31 
PQL_MPGFLQUOTA, Sys Mgmt Util M-Z 
C-31 

PQL_MPRCLM, Sys Mgmt Util M-Z, C-31 
PQL_MTQELM, Sys Mgmt Util M-Z, C-31 
PQL_MWSDEFAULT, Sys Mgmt Util M-Z 
C-31 

PQL_MWSEXTENT, Sys Mgmt Util M-Z, C-31 
PQL_MWSQUOTA, Sys Mgmt Util M-Z, C-31 
See also System parameters 
Process limits and quotas 

PRCPOLINTERVAL system parameter, Sys Mgmt 
Util M-Z, C-31 
Prefix list 

displaying on Alpha systems, Sys Mgmt Util 
M-Z, 6-42 

setting on Alpha systems, Sys Mgmt Util M-Z 
6-39 
Printers 

configuring in a LAT environment, Sys Mgmt 
Util A-L, 13-10, 13-35 

PRIORITY_OFFSET system parameter, Sys 
Mgmt Util M-Z, C-31 
Privileges, Sys Mgmt Util M-Z, 2-6 

assigning to installed images, Sys Mgmt Util 
A-L, 11-9 

assigning to known images, Sys Mgmt Util 
A-L, 11-7 

displaying current, Sys Mgmt Util M-Z, 6-58 
modifying for environment, Sys Mgmt Util 
M-Z, 6-54 

needed to perform BACKUP operations, Sys 
Mgmt Util A-L, 7-11 
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Privileges (cont’d) 

required by ACL editor, Sys Mgmt Util A-L, 

1-4 

required by SYSMAN, Sys Mgmt Util M-Z, 6-5 
Process activity statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1-40 
Processes 

granting identifiers to, Sys Mgmt Util A-L , 

1-15 

hibernation 

with ATTACH command, Sys Mgmt Util 
M-Z, 6-13 

switching control of input stream, Sys Mgmt 
Util M-Z, 6-13 

transferring control from, Sys Mgmt Util A-L, 
13-6 

PROCESSES class record 

in Monitor utility, Sys Mgmt Util M-Z, A-28 
Processor modes statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1-33 
/PROCESSOR qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-30 
Process states statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1-49 
Process types 

with Accounting utility, Sys Mgmt Util A-L , 

2-18 

PROCSECTCNT system parameter, Sys Mgmt 
Util M-Z, C-32 

PRODUCT command, Sys Mgmt Util M-Z, 3-3 
CONFIGURE subcommand, Sys Mgmt Util 
M-Z, 3-5 

COPY subcommand, Sys Mgmt Util M-Z, 3-7 
EXTRACT RELEASE_NOTES subcommand, 

Sys Mgmt Util M-Z, 3—9 
FIND subcommand, Sys Mgmt Util M-Z, 3-10 
INSTALL subcommand, Sys Mgmt Util M-Z, 

3-11 

PACKAGE subcommand, Sys Mgmt Util M-Z, 
3-13 

RECONFIGURE subcommand, Sys Mgmt Util 
M-Z, 3-14 

REGISTER PRODUCT subcommand, Sys 
Mgmt Util M-Z, 3—16 

REGISTER VOLUME subcommand, Sys Mgmt 
Util M-Z, 3-18 

REMOVE subcommand, Sys Mgmt Util M-Z, 
3-19 

SHOW HISTORY subcommand, Sys Mgmt Util 
M-Z, 3-20 

SHOW OBJECT subcommand, Sys Mgmt Util 
M-Z, 3-22 

SHOW PRODUCT subcommand, Sys Mgmt 
Util M-Z, 3-24 

Profiles, Sys Mgmt Util M-Z, 6—53 
adjusting, Sys Mgmt Util M-Z, 6-54 
displaying, Sys Mgmt Util M-Z, 6—58 
in SYSMAN, Sys Mgmt Util M-Z, 6-32 


and MOUNT command, Sys Mgmt Util M-Z, 
2-31 

default for foreign volumes, Sys Mgmt Util 
M-Z, 2-20 
Protection codes 

propagating UlC-based protection in a directory 
tree, Sys Mgmt Util A-L, 1—11 
/PROTECTION qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-50 
in Mount utility, Sys Mgmt Util M-Z, 2-31 
Protocol bit mask 

error definitions, Sys Mgmt Util A-L, 13-49 
Proxy accounts 

adding, Sys Mgmt Util A-L, 5-22 
deleting, Sys Mgmt Util A-L, 5-42 
modifying, Sys Mgmt Util A-L, 5—39 
Proxy logins, Sys Mgmt Util A-L, 5-22, 5-39 
PSEUDOLOA system parameter, Sys Mgmt Util 
M-Z, C-55 
PURGE command 

in Install utility, Sys Mgmt Util A-L, 11-17 
PURGE DEVICE command 

in LANCP utility, Sys Mgmt Util A-L, 12-20 
PURGE NODE command 

in LANCP utility, Sys Mgmt Util A-L, 12-20 
PU_OPTIONS system parameter, Sys Mgmt Util 
M-Z, C-32 


Q_ 

QBUS_MULT_INTR system parameter, Sys 
Mgmt Util M-Z, C-55 

QDSKINTERVAL system parameter, Sys Mgmt 
Util M-Z, C-32 

QDSKVOTES system parameter, Sys Mgmt Util 
M-Z, C-32 
Qualifiers 

command, Sys Mgmt Util A-L , 7-7 
input file-selection, Sys Mgmt Util A-L , 7—7 
input save-set, Sys Mgmt Util A-L , 7-7 
output file, Sys Mgmt Util A-L , 7—7 
output save-set, Sys Mgmt Util A-L , 7-7 
position-dependent, Sys Mgmt Util A-L , 7—7 
requiring special privileges, Sys Mgmt Util 
M-Z , 2-6 

QUANTUM system parameter, Sys Mgmt Util 
M-Z , C-32 
Quota checking 

controlling, Sys Mgmt Util M-Z , 2-32 
Quota file 

creating, Sys Mgmt Util M-Z , 6-23 
disabling, Sys Mgmt Util M-Z , 6-23 
displaying, Sys Mgmt Util M-Z , 6—29 
enabling, Sys Mgmt Util M-Z , 6-25 
modifying, Sys Mgmt Util M-Z , 6-25 
removing an entry, Sys Mgmt Util M-Z , 6—23, 
6-27 
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Quota file (cont’d) 

updating, Sys Mgmt Util M-Z, 6-26 
/QUOTA qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-32 

R 

Range checking 

disabling, Sys Mgmt Util M-Z, 6-44 
enabling, Sys Mgmt Util M-Z, 6-45 
/READ_CHECK qualifier, Sys Mgmt Util A-L, 3-9 
in Analyze/Disk_Structure utility, Sys Mgmt 
Util A-L, 3-9 

REALTIME_SPTS system parameter, Sys Mgmt 
Util M-Z, C-32 

REBOOT phase of AUTOGEN, Sys Mgmt Util 
A-L, 6—8 

/REBUILD qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-32 
RECALL command 

in LATCP, Sys Mgmt Util A-L, 13-23 
RECNXINTERVAL system parameter, Sys Mgmt 
Util M-Z, C-32 
RECONFIGURE command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-14 
Record blocking 

volume mount, Sys Mgmt Util M-Z, 2-24 
Recording file description 

in Monitor utility, Sys Mgmt Util M-Z, A-l 
Recording files 

class types, Sys Mgmt Util M-Z, A-8 
in Monitor utility 

class header, Sys Mgmt Util M-Z, A-9 
class prefix for component classes, Sys 
Mgmt Util M-Z, A-10 
class records, Sys Mgmt Util M-Z, A-8 
data block, Sys Mgmt Util M-Z, A-ll 
Digital control records, Sys Mgmt Util 
M-Z, A-3 

file header record, Sys Mgmt Util M-Z 
A-3 

I/O class record, Sys Mgmt Util M-Z, A-20 
node transition record, Sys Mgmt Util 
M-Z, A-7 

RMS class record, Sys Mgmt Util M-Z 
A-30 

RMS file record, Sys Mgmt Util M-Z, A-7 
SCS class record, Sys Mgmt Util M-Z 
A-36 

system information record, Sys Mgmt Util 
M-Z, A-5 

/RECORD qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-52 
in Monitor utility, Sys Mgmt Util M-Z, 1-13 
Records 

See also Security audit log files 
duplicating, Sys Mgmt Util A-L, 5-24 


Record size 

See Magnetic tape 
/RECORDSIZE qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-33 
Record type 

in Monitor utility, Sys Mgmt Util M-Z A-2 
/RECORD_ATTRIBUTES qualifier 

in Analyze/Disk_Structure utility, Sys Mgmt 
Util A-L, 3-10 

Recovering lost files, Sys Mgmt Util A-L, 3-4 
REFRESH command 


in LATCP, Sys Mgmt Util A-L, 13-24 
in Show Cluster utility, Sys Mgmt Util M-Z 
4-40 


REGISTER PRODUCT command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-16 
REGISTER VOLUME command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-18 

Release notes of software products, Sys Mgmt Util 
M-Z, 3-9 

/RELEASE_TAPE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-52 
RELOAD command 

in SYSGEN, Sys Mgmt Util M-Z, 5-15 
REMOVE (Field) command 

m Show Cluster utility, Sys Mgmt Util M-Z 
4-44 


REMOVE CIRCUITS command 

in Show Cluster utility, Sys Mgmt Util M-Z 
4-40 

REMOVE CLUSTER command 

in Show Cluster utility, Sys Mgmt Util M-Z, 


REMOVE command 

in Authorize utility, Sys Mgmt Util A-L, 5-41 
in Install utility, Sys Mgmt Util A-L, 11-18 
in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-19 
REMOVE CONNECTIONS command 

in Show Cluster utility, Sys Mgmt Util M-Z 
4-42 

REMOVE COUNTERS command 

in Show Cluster utility, Sys Mgmt Util M-Z 
4-43 


REMOVE CREDITS command 

in Show Cluster utility, Sys Mgmt Util M-Z 
4-43 

REMOVE ERRORS command 

in Show Cluster utility, Sys Mgmt Util M-Z 
4—44 

REMOVE/IDENTIFIER command 

in Authorize utility, Sys Mgmt Util A-L, 5-41 

REMOVE LOCAL_PORTS command 

in Show Cluster utility, Sys Mgmt Util M-Z 
4-45 


Index-27 













REMOVE MEMBERS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 

4-46 

REMOVE/PROXY command 

in Authorize utility, Sys Mgmt Util A-L, 5—42 
REMOVE SYSTEMS command 

in Show Cluster utility, Sys Mgmt Util M-Z, 

4— 46 

Removing installed software, Sys Mgmt Util M-Z, 

3-19 

RENAME command 

in Authorize utility, Sys Mgmt Util A-L, 5-43 
RENAME/IDENTIFIER command 

in Authorize utility, Sys Mgmt Util A-L, 5-45 
REPAIR command 

in LMCP, Sys Mgmt Util A-L, 14-13 
Repairing errors, Sys Mgmt Util A-L, 3-3, 3-7, 

3-8, 3-10, 3-11 
/REPAIR qualifier 

in Analyze/Disk_Structure utility, Sys Mgmt 

Util A-L, 3-11 
REPLACE command 

in Install utility, Sys Mgmt Util A-L, 11-18 
/REPLACE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-53 
Report formats from Audit Analysis utility 
brief, Sys Mgmt Util A-L, 4-7 
full, Sys Mgmt Util A-L, 4-9 
summary, Sys Mgmt Util A-L, 4—23 
Reporting errors, Sys Mgmt Util A-L, 3-3 
Reports 

SHOW CLUSTER, Sys Mgmt Util M-Z, 4-3 
command to modify, Sys Mgmt Util M-Z, 
B-3 

controlling the display, Sys Mgmt Util 
M-Z, 4-4 

default display, Sys Mgmt Util M-Z, 4-37 
formatting, Sys Mgmt Util M-Z, 4-52 
organization of, Sys Mgmt Util M-Z, 4—3 
printing, Sys Mgmt Util M-Z, 4-55 
time period for, Sys Mgmt Util M-Z, 4—6, 

4-7 

update interval, Sys Mgmt Util M-Z, 4-8, 

4-54 

Requirements and limitations 

in AN ALYZE/DISK_STRUCTURE, Sys Mgmt 
Util A-L, 3—6 

RESALLOC system parameter, Sys Mgmt Util 
M-Z, C-55 

RESHASHTBL system parameter, Sys Mgmt Util 
M-Z, C-32 
Resource accounting 

programming information, Sys Mgmt Util A-L, 

c-i 

Resource attributes, Sys Mgmt Util A-L, 5—21, 

5- 29, 5-37 


Resources tat 

producing usage reports of, Sys Mgmt Util A-L, 

2-9, 2-11 
Resource use 

producing reports of, Sys Mgmt Util A-L, Z ll, 
2-25 
Restrictions 

in using SYSMAN, Sys Mgmt Util M-Z, 6-5 
Mount utility, Sys Mgmt Util M-Z, 2-6 
Retransmit limit, Sys Mgmt Util A-L, 13-31 
REVOKE/IDENTIFIER command 

in Authorize utility, Sys Mgmt Util A-L, 5-45 
/REWIND qualifier 

as Backup utility input save-set qualifier, Sys 
Mgmt Util A-L, 7-54 

as Backup utility output save-set qualifier, Sys 
Mgmt Util A-L, 7-55 
Rights databases 

See RIGHTSLIST.DAT files 
Rights identifier, Sys Mgmt Util M-Z, 6-25 
for disk quota file, Sys Mgmt Util M-Z, 6-21 
RIGHTSLIST.DAT files 

adding identifiers to, Sys Mgmt Util A-L, 5-20 
altering identifiers in, Sys Mgmt Util A-L, 5-37 
creating and maintaining, Sys Mgmt Util A-L, 
5-3, 5-26 

deleting identifiers from, Sys Mgmt Util A-L, 

5-41 

displaying identifiers in, Sys Mgmt Util A-L, 

5-50 

displaying records in, Sys Mgmt Util A-L, 5—54 
renaming identifiers, Sys Mgmt Util A-L, 5—45 
RJOBLIM system parameter, Sys Mgmt Util M-Z, 
C-32 

RMS (Record Management Services) 

See RMS 
RMS statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1-43 
RMS system parameters 

RMS_DFMBC, Sys Mgmt Util M-Z, C-33 
RMS_DFMBFHSH, Sys Mgmt Util M-Z, C-33 
RMS_DFMBFIDX, Sys Mgmt Util M-Z, C-33 
RMS_DFMBFREL, Sys Mgmt Util M-Z, C-33 
RMS_DFMBFSDK, Sys Mgmt Util M-Z, C-33 
RMS_DFMBFSMT, Sys Mgmt Util M-Z, C-33 
RMS_DFMBFSUR, Sys Mgmt Util M-Z, C-33 
RMS_DFNBC, Sys Mgmt Util M-Z, C-33 
RMS_EXTEND_SIZE, Sys Mgmt Util M-Z, 
C-33 

RMS.FILEPROT, Sys Mgmt Util M-Z, C-34 
RMS_GBLBUFQUO, Sys Mgmt Util M-Z, C-34 
RMS_PROLOGUE, Sys Mgmt Util M-Z, C-34 
RMTDBG_SCRATCH_PAGES system parameter, 
Sys Mgmt Util M-Z, C-34 
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RSRVPAGCNT system parameter, Sys Mgmt Util 
M-Z, C-55 

s 

SO_PAGING system parameter, Sys Mgmt Util 

M-Z, C-55 
SAVE command 

in Show Cluster utility, Sys Mgmt Util M-Z 
4—48 

SAVEDUMP system parameter, Sys Mgmt Util 
M-Z, C-34 
Save sets 

description of, Sys Mgmt Util A-L, 7-3 
directing output to, Sys Mgmt Util A-L, 7-11 
Save-set specification, Sys Mgmt Util A-L, 7-5 
/SAVE_SET qualifier 

as Backup utility input save-set qualifier, Sys 
Mgmt Util A-L, 7-58 

as Backup utility output save-set qualifier, Sys 
Mgmt Util A-L, 7-58 

SAVPARAMS phase of AUTOGEN, Sys Mgmt Util 
A-L, 6—6 

SA_APP system parameter, Sys Mgmt Util M-Z 
C-55 

SBIERRENABLE system parameter, Sys Mgmt 
Util M-Z, C-55 

SOHCTLFLAGS system parameter, Sys Mgmt 
Util M-Z, C-34 
Screens 

refreshing from LATCP, Sys Mgmt Util A-L, 
13-24 

SCROLL command 

in LATCP, Sys Mgmt Util A-L, 13-25 
in Show Cluster utility, Sys Mgmt Util M-Z, 
4-49 

SCROLL keypad function, Sys Mgmt Util M-Z, 

B-3 

SCS (System Communications Services) 

See also SCS 

SHOW CLUSTER information, Sys Mgmt Util 
M-Z, 4-3 

SCSI_NOAUTO system parameter, Sys Mgmt 
Util M-Z, C-55 
SCS statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1-46 
SCSSYSTEMID system parameter 

and LATCP CREATE LINK command, Sys 
Mgmt Util A-L, 13-7 
SCS system parameters 

SCSBUFFCNT, Sys Mgmt Util M-Z, C-35 
SCSCONNCNT, Sys Mgmt Util M-Z, C-35 
SCSFLOWCUSH, Sys Mgmt Util M-Z, C-35 
SCSMAXDG, Sys Mgmt Util M-Z, C-35 
SCSMAXMSG, Sys Mgmt Util M-Z, C-35 
SCSNODE, Sys Mgmt Util M-Z, C-35 
SCSRESPCNT, Sys Mgmt Util M-Z, C-35 
SCSSYSTEMID, Sys Mgmt Util M-Z, C-36 


SCS system parameters (cont’d) 

SCSSYSTEMIDH, Sys Mgmt Util M-Z, C-36 
SECAUDIT.COM command procedure 
See Audit Analysis utility 
Security Alarm ACEs 
See Alarm ACEs 
Security alarm messages 

specifying access criteria for, Sys Mgmt Util 
A-L, 1-6, 1-8 

Security archive files, analyzing, Sys Mgmt Util 
A-L, 4-4 

Security Audit ACEs 
See Audit ACEs 
Security audit data packets 

fields, Sys Mgmt Util A-L, F-6 
format, Sys Mgmt Util A-L, F-6 
Security audit event flags, Sys Mgmt Util A-L 
F-6 

Security audit event messages 

data packets in, Sys Mgmt Util A-L, F-6 
event flags, Sys Mgmt Util A-L, F-6 
format, Sys Mgmt Util A-L, F-l 
subtypes for events, Sys Mgmt Util A-L, F-2 
types of events, Sys Mgmt Util A-L, F-2 
Security audit header packets, Sys Mgmt Util 
A-L, F-2 

Security audit log files 

advancing to next record, Sys Mgmt Util A-L 
4-29 

analyzing, Sys Mgmt Util A-L, 4-4 
data packet format, Sys Mgmt Util A-L, F-6 
displaying records, Sys Mgmt Util A-L, 4-25 
displaying the full record, Sys Mgmt Util A-L, 
4-9 

excluding information from reports, Sys Mgmt 
Util A-L, 4-9 

header packet format, Sys Mgmt Util A-L, F-l 
opening new input file, Sys Mgmt Util A-L 
4-28 

resuming processing, Sys Mgmt Util A-L, 4-25 
returning to previous record, Sys Mgmt Util 
A-L, 4-29 

selecting records by event class, Sys Mgmt Util 
A-L, 4—7 

selecting records by time, Sys Mgmt Util A-L 
4-5, 4-22 

specifying duration of record display, Sys 
Mgmt Util A-L, 4-12 

writing alarm messages to, Sys Mgmt Util A-L 
1-8 

Security audit records 

criteria for selecting, Sys Mgmt Util A-L, 4-12 
Security audit reports 

advancing the display, Sys Mgmt Util A-L, 

4-29 

binary output, Sys Mgmt Util A-L, 4-6 
brief format, Sys Mgmt Util A-L, 4-7 
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Security audit reports (cont’d) 

creating, Sys Mgmt Util A-L, 4-4 
directing output, Sys Mgmt Util A-L , 4-11 
displaying selection criteria, Sys Mgmt Util 
A-L , 4-30 

duration of record display, Sys Mgmt Util A-L , 
4-12 

excluding information, Sys Mgmt Util A-L , 4-9 
full format, Sys Mgmt Util A-L , 4-9 
interrupting the display, Sys Mgmt Util A-L, 
4-25 

modifying selection criteria, Sys Mgmt Util 
A-L , 4-25 

processing additional log files, Sys Mgmt Util 
A-L , 4-28 

resuming the processing, Sys Mgmt Util A-L, 
4-25 

summary of records, Sys Mgmt Util A-L , 4-23 
Security event classes 

extracting audit records by, Sys Mgmt Util 
A-L , 4-7 

Security event messages 

extracting from log files, Sys Mgmt Util A-L, 
4-4 

Security objects 

classes, Sys Mgmt Util A-L , 1-4 
Security operators 

sending alarm messages to audit log files, Sys 
Mgmt Util A-L , 1-8 

sending alarm messages to terminals, Sys 
Mgmt Util A-L , 1-6 

SECURITY.POLICY system parameter, Sys 
Mgmt Util M-Z , C-36 
SELECT command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-50 

/SELECT qualifier 

in Backup utility, Sys Mgmt Util A-L , 7-59 
Sending comments to Digital writers, Sys Mgmt 
Util A-L , iii; Sys Mgmt Util M-Z , iii 
Servers 

MSCP, Sys Mgmt Util M-Z , 5-14 
Service node, Sys Mgmt Util A-L , 13—3 
controlling access to, Sys Mgmt Util A-L, 
13-29, 13-33 

deleting a port, Sys Mgmt Util A-L , 13-20 
modifying characteristics of, Sys Mgra* Util 
A-L , 13-27, 13-39 
naming, Sys Mgmt Util A-L , 13—37 
service announcements, Sys Mgmt Util A-L, 
13-30 
Services 

application, Sys Mgmt Util A-L, 13—10, 13—14, 
13-16, 13-36, 13-39 

creating with LATCP, Sys Mgmt Util A-L, 
13-14 

database, Sys Mgmt Util A-L, 13—30, 13—33 


Services (cont’d) 

deleting with LATCP, Sys Mgmt Util A-L, 

13-21 

displaying characteristics of, Sys Mgmt Util 
A-L , 13-58 

displaying counters, Sys Mgmt Util A-L, 13-57 
displaying information using LATCP, Sys 
Mgmt Util A-L, 13-57 

general timesharing, Sys Mgmt Util A-L, 13-16 
identifier, Sys Mgmt Util A-L, 13-14, 13-30, 
13-39 

limiting size of node database, Sys Mgmt Util 
A-L, 13-30, 13-33 

modifying characteristics of, Sys Mgmt Util 
A-L, 13-39 

naming with LATCP, Sys Mgmt Util A-L, 
13-14, 13-26 

rating, Sys Mgmt Util A-L, 13—15, 13—40, 
13-51, 13-58 

responder, Sys Mgmt Util A-L, 13—31 
target, Sys Mgmt Util A-L, 13—54 
Session limit, Sys Mgmt Util A-L, 13-31 
Sessions 

terminating, Sys Mgmt Util A-L, 3-6 
SET ACP command 

in LANCP utility, Sys Mgmt Util A-L, 12-21 
SET AUDIT command 

recording alarm messages, Sys Mgmt Util A-L, 
1-8 

SET AUTOJPOSITIONING command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-51 

SET command 

(Field), Sys Mgmt Util M-Z, 4-52 
in SYSGEN, Sys Mgmt Util M-Z, 5-15 
SET DEFAULT command, Sys Mgmt Util M-Z, 
1-60 

in Monitor utility, Sys Mgmt Util M-Z, 1-60 
SET DEVICE command 

in LANCP utility, Sys Mgmt Util A-L, 12-22, 
12-26 

SET ENVIRONMENT command 

in SYSMAN, Sys Mgmt Util M-Z, 6-52 
SET FUNCTION command, Sys Mgmt Util M-Z, 
B-3 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-53 

SET INTERVAL command 

in Show Cluster utility, Sys Mgmt Util M-Z, 
4-54 

SET LINK command 

in LATCP, Sys Mgmt Util A-L, 13-26 
SET NODE command 

in LANCP utility, Sys Mgmt Util A-L, 12-28 
in LATCP, Sys Mgmt Util A-L, 13-27 
SET/OUTPUT command 

in SYSGEN, Sys Mgmt Util M-Z, 5-16 
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SETPARAMS.DAT file, Sys Mgmt Util A-L, 6-7 
SETPARAMS phase of AUTOGEN, Sys Mgmt 
Util A-L, 6-7 
SET PORT command 

in LATCP, Sys Mgmt Util A-L, 13-35 
SET PROFILE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-54 
SET QUORUM command 

avoiding use of /CLUSTER with SYSMAN DO 
command, Sys Mgmt Util M-Z, 6-31 
SET SCREEN command 

in Show Cluster utility, Sys Mgmt Util M-Z 
4-54 

SET SECURITY command 

/CLASS qualifier, Sys Mgmt Util A-L, 1-5 
specifying object class, Sys Mgmt Util A-L, 1-5 
SET SECURITY/EDIT command, Sys Mgmt Util 
A-L, 1-4, 1-17 
SET SERVICE command 

in LATCP, Sys Mgmt Util A-L, 13-39 
SET/STARTUP command 

in SYSGEN, Sys Mgmt Util M-Z, 5-17 
SET TIMEOUT command, Sys Mgmt Util M-Z 
6-55 

in SYSMAN, Sys Mgmt Util M-Z, 6-55 
SETTIME system parameter, Sys Mgmt Util M-Z 
C-36 

Setting page, swap, and dump file sizes, Sys 
Mgmt Util A-L, 6-3 

SHADOWING system parameter, Sys Mgmt Util 
M-Z, C-37 
/SHADOW qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-34 
SHADOW_MAX_COPY system parameter, Sys 
Mgmt Util M-Z, C-37 

SHADOW_MBR_TMO system parameter, Sys 
Mgmt Util M-Z, C-37 

SHADOW_REMOVE_l system parameter, Sys 
Mgmt Util M-Z, C-37 

SHADOW_SYS_DISK system parameter, Sys 
Mgmt Util M-Z, C-38 

SHADOW_SYS_TMO system parameter, Sys 
Mgmt Util M-Z, C-38 

SHADOW_SYS_UNIT system parameter, Sys 
Mgmt Util M-Z, C-38 

SHADOW_SYS_WAIT system parameter, Sys 
Mgmt Util M-Z, C-38 
SHARE command 

in SYSGEN, Sys Mgmt Util M-Z, 5-17 
SHARE/INITIALIZE command 

in SYSGEN, Sys Mgmt Util M-Z, 5-18 
/SHARE qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-35 
SHOW/ADAPTER command 

in SYSGEN, Sys Mgmt Util M-Z, 5-23 
SHOW/BUS command 

in SYSGEN, Sys Mgmt Util M-Z, 5-24 


SHOW CLUSTER command 

m Show Cluster utility, Sys Mgmt Util M-Z 
4-5 

Show Cluster utility (SHOW CLUSTER) 

See also Reports, SHOW CLUSTER 
activation time, Sys Mgmt Util M-Z, 4-6 4-7 
4-8, 4-54 

classes of data, Sys Mgmt Util M-Z, 4-3 
commands, Sys Mgmt Util M-Z, 4-9 
continuous mode, Sys Mgmt Util M-Z, 4-5, 4-7 
controlling displays, Sys Mgmt Util M-Z, 4-4 
data fields, Sys Mgmt Util M-Z, 4-3 
defining arrow keys, Sys Mgmt Util M-Z, B-3 
defining keypad keys, Sys Mgmt Util M-Z, 
4-33, B-3 

deselecting window, Sys Mgmt Util M-Z, 4-35 
directing output, Sys Mgmt Util M-Z, 4-5 
Execute Procedure (@) command, Sys Mgmt 
Util M-Z, 4-11 

exiting, Sys Mgmt Util M-Z, 4-5, 4-35 
invoking, Sys Mgmt Util M-Z, 4-5 
keypad, Sys Mgmt Util M-Z, B-l 
moving display window, Sys Mgmt Util M-Z 
4-37, 4-50 

panning display window, Sys Mgmt Util M-Z 
4-39 

qualifiers, Sys Mgmt Util M-Z, 4-6 
refreshing the display, Sys Mgmt Util M-Z, 

4-40 

removing display information, Sys Mgmt Util 
M-Z, 4-40 to 4-46 

resetting display information, Sys Mgmt Util 
M-Z, 4-37 

sample display, Sys Mgmt Util M-Z, 4-3 
scrolling display window, Sys Mgmt Util M-Z 
4-39, 4-50 

selecting display fields, Sys Mgmt Util M-Z 
4-19 

CIRCUITS class, Sys Mgmt Util M-Z, 4-11 
CLUSTER class, Sys Mgmt Util M-Z, 4-13 
CONNECTIONS class, Sys Mgmt Util 
M-Z, 4-14 

COUNTERS class, Sys Mgmt Util M-Z 
4-15 

CREDITS class, Sys Mgmt Util M-Z, 4-17 
ERRORS class, Sys Mgmt Util M-Z, 4-18 
LOCAL_PORTS class, Sys Mgmt Util M-Z 
4-28 

MEMBERS class, Sys Mgmt Util M-Z 
4-30 

SYSTEMS class, Sys Mgmt Util M-Z, 4-31 
selecting display window, Sys Mgmt Util M-Z 
4-50 

SHOW command 

in Audit Analysis utility, Sys Mgmt Util A-L, 
4-30 

in Authorize utility, Sys Mgmt Util A-L, 5-46 
in CLUE, Sys Mgmt Util A-L, 8-8 
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SHOW CONFIGURATION command 

in LANCP utility, Sys Mgmt Util A-L, 12-31 
SHOW/CONFIGURATION command 
in SYSGEN, Sys Mgmt Util M-Z, 5-24 
SHOW DEFAULT command 

in Monitor utility, Sys Mgmt Util M-Z, 1-61 
SHOW DEVICE command 

in LANCP utility, Sys Mgmt Util A-L, 12-32 
SHOW/DEVICE command 

in SYSGEN, Sys Mgmt Util M-Z, 5-27 
SHOW/DRIVER command 

in SYSGEN, Sys Mgmt Util M-Z, 5-28 
SHOW ENVIRONMENT command, Sys Mgmt 
Util M-Z, 6-53, 6-56 
in SYSMAN, Sys Mgmt Util M-Z, 6-56 
SHOW HISTORY command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3—20 
SHOW/IDENTIFIER command 

in Authorize utility, Sys Mgmt Util A-L, 5-50 
SHOW KEY command 

in SYSMAN, Sys Mgmt Util M-Z, 6-57 
SHOW LINK command 

in LATCP, Sys Mgmt Util A-L, 13-41 
SHOW LOG command 

in LANCP utility, Sys Mgmt Util A-L, 12-35 
in LMCP, Sys Mgmt Util A-L, 14-16 
SHOW MOPDLL command 

in LANCP utility, Sys Mgmt Util A-L, 12-37 
SHOW NODE command 

in LANCP utility, Sys Mgmt Util A-L, 12-37 
in LATCP, Sys Mgmt Util A-L, 13-46 
SHOW OBJECT command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3—22 
SHOW PORT command 

in LATCP, Sys Mgmt Util A-L, 13-52 
SHOW PRODUCT command 

in POLYCENTER Software Installation utility, 
Sys Mgmt Util M-Z, 3-24 
SHOW PROFILE command, Sys Mgmt Util M-Z, 
6-58 

in SYSMAN, Sys Mgmt Util M-Z, 6-58 
SHOW/PROXY command 

in Authorize utility, Sys Mgmt Util A-L, 5—52 
SHOW QUEUE_ENTRY command 

in LATCP, Sys Mgmt Util A-L, 13-55 
SHOW/RIGHTS command 

in Authorize utility, Sys Mgmt Util A-L, 5-54 
SHOW SERVICE command 

in LATCP, Sys Mgmt Util A-L, 13-57 
SHOW/STARTUP command, Sys Mgmt Util M-Z, 
5-29 

SHOW TIME command 

in SYSMAN, Sys Mgmt Util M-Z, 6-58 


SHOW TIMEOUT command, Sys Mgmt Util M-Z, 
6-58 

SHOW/TURBOCHANNEL command 
in SYSGEN, Sys Mgmt Util M-Z, 5-29 
SHOW/UNIBUS command 

in SYSGEN, Sys Mgmt Util M-Z, 5-30 
SHOW [parameter] command 

in SYSGEN, Sys Mgmt Util M-Z, 5-20 
SHOW_CLUSTER$INIT, Sys Mgmt Util M-Z, 

4-11 

SHUTDOWN NODE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-59 
SHUTDOWN phase of AUTOGEN, Sys Mgmt Util 
A-L, 6-8 
/SINCE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-60 
SMP_CPUSH system parameter, Sys Mgmt Util 
M-Z, C-55 

SMP_CPUS system parameter, Sys Mgmt Util 
M-Z, C-38 

SMP_LNGSPINWAIT system parameter, Sys 
Mgmt Util M-Z, C—39 

SMP_SANITY_CNT system parameter, Sys Mgmt 
Util M-Z, C-39 

SMP_SPINWAIT system parameter, Sys Mgmt 
Util M-Z, C-39 

SMP_TICK_CNT system parameter, Sys Mgmt 
Util M-Z, C-55 
SPAWN command 

and ATTACH command, Sys Mgmt Util M-Z, 
6-13 

in LANCP utility, Sys Mgmt Util A-L, 12—39 
in LATCP, Sys Mgmt Util A-L, 13-59 
in SYSMAN, Sys Mgmt Util M-Z, 6-62 
SPTREQ system parameter, Sys Mgmt Util M-Z, 
C-39 

SSINHIBIT system parameter, Sys Mgmt Util 
M-Z, C-56 

Stage checks, Sys Mgmt Util A-L, D—1 
Standalone BACKUP, Sys Mgmt Util A-L, 7-11 
Start phase of AUTOGEN, Sys Mgmt Util A-L, 
6-5 

default, Sys Mgmt Util A-L, 6—10 
Startup 

logging, Sys Mgmt Util M-Z, 6—72 
phase, Sys Mgmt Util M-Z, 6-66 
status, Sys Mgmt Util M-Z, 6—72 
STARTUP$STARTUP_LAYERED logical name, 

Sys Mgmt Util M-Z, 6—71 
STARTUP$STARTUP_VMS logical name, Sys 
Mgmt Util M-Z, 6—71 
STARTUP ADD command 

in SYSMAN, Sys Mgmt Util M-Z, 6-65 
Startup command procedure, Sys Mgmt Util M-Z, 
5-17, 5-31, 5-32 

setting the name, Sys Mgmt Util M-Z, 6-46 
site-independent file name, Sys Mgmt Util 
M-Z, 5-29 
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Startup database 

establishing, Sys Mgmt Util M-Z, 6-71 
files 

adding, Sys Mgmt Util M-Z, 6-65 
deleting, Sys Mgmt Util M-Z, 6-70 
disabling, Sys Mgmt Util M-Z, 6-67 
enabling, Sys Mgmt Util M-Z, 6-68 
modifying, Sys Mgmt Util M-Z, 6-69 
setting the default, Sys Mgmt Util M-Z, 6-71 
STARTUP DISABLE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-67 
STARTUP ENABLE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-68 
STARTUP MODIFY command 

in SYSMAN, Sys Mgmt Util M-Z, 6-69 
STARTUP REMOVE command 

in SYSMAN, Sys Mgmt Util M-Z, 6-70 
STARTUP SET DATABASE command 
in SYSMAN, Sys Mgmt Util M-Z, 6-71 
STARTUP SET OPTIONS command 
in SYSMAN, Sys Mgmt Util M-Z, 6-72 
STARTUP SHOW command 

in SYSMAN, Sys Mgmt Util M-Z, 6-73 
STARTUP_Pn system parameters, Sys Mgmt Util 
M-Z, C-39 

in SYSMAN, Sys Mgmt Util M-Z, 6-66 
STATES class record 

in Monitor utility, Sys Mgmt Util M-Z, A-38 
Static service rating, Sys Mgmt Util A-L, 13-15 
13-40 

displaying, Sys Mgmt Util A-L, 13-51, 13-58 
Subprocesses 

See also SPAWN command 

creating from LATCP, Sys Mgmt Util A-L, 

13-6, 13-59 

creating with SPAWN command, Sys Mgmt 
Util M-Z, 6-62 

creating with the LANCP SPAWN command, 

Sys Mgmt Util A-L, 12-39 
switching control of input stream to, Sys Mgmt 
Util M-Z, 6-13 

Subsystem ACEs, Sys Mgmt Util A-L, 1-15 
example, Sys Mgmt Util A-L, 1-15 
specifying identifier characteristics, Sys Mgmt 
Util A-L, 1-16 

specifying identifiers, Sys Mgmt Util A-L, 1-16 
Subsystem attribute, Sys Mgmt Util A-L, 5-21 
5-29, 5-37 

/SUBSYSTEM qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-35 
Subsystems 

controlling access to, Sys Mgmt Util A-L 1-15 
/SUMMARY qualifier 

in Monitor utility, Sys Mgmt Util M-Z, 1-13 
Summary report 

example, Sys Mgmt Util A-L, 9-24 


Supplementary Volume Descriptor 
See SVD 

SVD (Supplementary Volume Descriptor), Sys 
Mgmt Util M-Z, 2-36 
SWAPFILE.SYS file 
See Swap files 
Swap files 

changing size, Sys Mgmt Util A-L, 6-3 
displaying the size calculated by AUTOGEN, 
Sys Mgmt Util A-L, 6-7 

generating a new file sized by AUTOGEN, Sys 
Mgmt Util A-L, 6-7 

SWPALLOCINC system parameter, Sys Mgmt 
Util M-Z, C-56 

SWPFAIL system parameter, Sys Mgmt Util M-Z 
C-56 

SWPFILCNT system parameter, Sys Mgmt Util 
M-Z, C-40 

SWPOUTPGCNT system parameter, Sys Mgmt 
Util M-Z, C-40 

SWPRATE system parameter, Sys Mgmt Util 
M-Z, C-56 

SWP_PRIO system parameter, Sys Mgmt Util 
M-Z, C-56 
Symbol table 

command interpreter, Sys Mgmt Util M-Z 
C-ll 

Syntax 

of BACKUP commands, Sys Mgmt Util A-L 
7-5 

SYS$SYSTEM:STARTUP.COM command 
procedure, Sys Mgmt Util M-Z, D-6 
SYSALF.DAT database in SYSMAN, Sys Mgmt 
Util M-Z, 6-11 
SYSBOOT facility 

using during bootstrap operations, Sys Mgmt 
Util M-Z, 5-3 
SYSDUMP.DMP file 
See Dump files 
SYSGEN 

See System Generation utility (SYSGEN) 
SYSLOST.DIR file, Sys Mgmt Util A-L, 3—4 
SYSMAN 

See System Management utility (SYSMAN) 
SYSMANINI.INI file 

changing file specification, Sys Mgmt Util M-Z 
6-4 

SYSMWCNT system parameter, Sys Mgmt Util 
M-Z, C-40 

SYSPFC system parameter, Sys Mgmt Util M-Z 
C-56 

SYSTEM class record 

in Monitor utility, Sys Mgmt Util M-Z, A-40 
System Communications Services 
See SCS 
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System Generation utility (SYSGEN), Sys Mgmt 
Util M-Z, 5—3 

assign parameter values, Sys Mgmt Util M-Z, 
5-15 

commands 

AUTOCONFIGURE, Sys Mgmt Util M-Z, 
5-5 

CONFIGURE, Sys Mgmt Util M-Z, 5-7 
CONNECT/ADAPTER, Sys Mgmt Util 
M-Z, 5-9 

CREATE, Sys Mgmt Util M-Z, 5-11 
DEINSTALL, Sys Mgmt Util M-Z, 5-11 
DISABLE, Sys Mgmt Util M-Z, 5-12 
ENABLE, Sys Mgmt Util M-Z, 5-13 
INSTALL, Sys Mgmt Util M-Z, 5-13 
LOAD, Sys Mgmt Util M-Z, 5-14 
MSCP, Sys Mgmt Util M-Z, 5-14 
RELOAD, Sys Mgmt Util M-Z, 5-15 
SET, Sys Mgmt Util M-Z, 5-15 
SET/OUTPUT, Sys Mgmt Util M-Z, 5-16 
SET/STARTUP, Sys Mgmt Util M-Z, 5-17 
SHARE, Sys Mgmt Util M-Z, 5-17 
SHARE/INITIALIZE, Sys Mgmt Util M-Z, 
5-18 

SHOW, Sys Mgmt Util M-Z, 5-20 
SHOW/ADAPTER, Sys Mgmt Util M-Z, 
5-23 

SHOW/BUS, Sys Mgmt Util M-Z, 5-24 
SHOW/CONFIGURATION, Sys Mgmt Util 
M-Z, 5-24 

SHOW/DEVICE, Sys Mgmt Util M-Z, 5-27 
SHOW/DRIVER, Sys Mgmt Util M-Z, 5-28 
SHOW/STARTUP, Sys Mgmt Util M-Z, 
5-29 

SHOW/TURBOCHANNEL, Sys Mgmt Util 
M-Z, 5-29 

SHOW/UNIBUS, Sys Mgmt Util M-Z, 5-30 
TERMINAL, Sys Mgmt Util M-Z, 5-31 
USE, Sys Mgmt Util M-Z, 5-32 
WRITE, Sys Mgmt Util M-Z, 5-33 

parameters 

See also System parameters 
showing parameter values, Sys Mgmt Util 
M-Z, 5-20 

work area, Sys Mgmt Util M-Z, 5—15, 5—32, 

5- 33 

System loadable image 

adding, Sys Mgmt Util M-Z, 6-74 
removing, Sys Mgmt Util M-Z, 6—76 
System management 

clearing counters, Sys Mgmt Util A-L, 12-9 
creating disk quota files, Sys Mgmt Util M-Z, 

6- 23 

defining target system, Sys Mgmt Util M-Z, 
6-52 

deleting device information, Sys Mgmt Util 
A-L, 12-8, 12-20 


System management (cont’d) 

deleting node information, Sys Mgmt Util A-L, 
12-9, 12-20 

displaying LAN device parameters, Sys Mgmt 
Util A-L, 12-17, 12-32 
displaying node information, Sys Mgmt Util 
A-L, 12-18, 12-37 

displaying OPCOM messages, Sys Mgmt Util 
A-L, 12-21 

displaying status and counters, Sys Mgmt Util 
A-L, 12-18, 12-37 

displaying target environment, Sys Mgmt Util 
M-Z, 6-56 

displaying user profile, Sys Mgmt Util M-Z, 

6-58 

displaying wait time for node response, Sys 
Mgmt Util M-Z, 6—58 

invoking the LANCP utility, Sys Mgmt Util 
A-L, 12-4 

LANCP SPAWN command, Sys Mgmt Util A-L, 
12-39 

limiting response time, Sys Mgmt Util M-Z, 
6-55 

MOP console carrier, Sys Mgmt Util A-L, 

12-10 

MOP trigger boot, Sys Mgmt Util A-L, 12-40 
setting device information, Sys Mgmt Util A-L, 
12-11 

setting wait time for node response, Sys Mgmt 
Util M-Z, 6-55 
startup procedures 

See also Startup database 
SYSMAN tasks, Sys Mgmt Util M-Z, 6-3 
System management environment 
See Management environment 
System Management utility (SYSMAN) 
commands 

ALF ADD, Sys Mgmt Util M-Z, 6-10 
ALF REMOVE, Sys Mgmt Util M-Z, 6-11 
ALF SHOW, Sys Mgmt Util M-Z, 6-13 
ATTACH, Sys Mgmt Util M-Z, 6-13 
CONFIGURATION SET CLUSTER_AUTH, 
Sys Mgmt Util M-Z, 6—15 
CONFIGURATION SET TIME, Sys Mgmt 
Util M-Z, 6-16 

CONFIGURATION SHOW CLUSTER. 
AUTHORIZATION, Sys Mgmt Util 
M-Z, 6-17 

CONFIGURATION SHOW TIME, Sys 
Mgmt Util M-Z, 6—18 
DISKQUOTA ADD, Sys Mgmt Util M-Z, 
6-21 

DISKQUOTA CREATE, Sys Mgmt Util 
M-Z, 6-22 

DISKQUOTA DELETE, Sys Mgmt Util 
M-Z, 6-23 
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System Management utility (SYSMAN) 
commands (cont’d) 

DISKQUOTA DISABLE, Sys Mgmt Util 
M-Z , 6-23 

DISKQUOTA ENABLE, Sys Mgmt Util 
M-Z, 6-24 

DISKQUOTA MODIFY, Sys Mgmt Util 
M-Z, 6-25 

DISKQUOTA REBUILD, Sys Mgmt Util 
M-Z, 6-26 

DISKQUOTA REMOVE, Sys Mgmt Util 
M-Z, 6-27 

DISKQUOTA SHOW, Sys Mgmt Util M-Z 
6-29 

DO, Sys Mgmt Util M-Z, 6-30 
EXITx, Sys Mgmt Util M-Z, 6-32 
HELPx, Sys Mgmt Util M-Z, 6-32 
10 AUTOCONFIGURE, Sys Mgmt Util 
M-Z, 6-33 

10 CONNECT, Sys Mgmt Util M-Z, 6-34 
10 LOAD, Sys Mgmt Util M-Z, 6-37 
10 SET PREFIX, Sys Mgmt Util M-Z, 
6-38, 6-39 

10 SHOW BUS, Sys Mgmt Util M-Z, 6-39 
10 SHOW DEVICE, Sys Mgmt Util M-Z 
6-40 

10 SHOW EXCLUDE, Sys Mgmt Util M-Z 
6-41 

10 SHOW PREFIX, Sys Mgmt Util M-Z, 
6-42 

LICENSE LOAD, Sys Mgmt Util M-Z 
6-43 

LICENSE UNLOAD, Sys Mgmt Util M-Z, 
6-43 

PARAMETERS DISABLE CHECKS, Sys 
Mgmt Util M-Z, 6-44 
PARAMETERS ENABLE CHECKS, Sys 
Mgmt Util M-Z, 6-45 
PARAMETERS SET, Sys Mgmt Util M-Z, 
6-46 

PARAMETERS SHOW, Sys Mgmt Util 
M-Z, 6—47 

PARAMETERS USE, Sys Mgmt Util M-Z, 
6-50 

PARAMETERS WRITE, Sys Mgmt Util 
M-Z, 6-51 

SET ENVIRONMENT, Sys Mgmt Util 
M-Z, 6-52 

SET PROFILE, Sys Mgmt Util M-Z, 6-54 
SET TIMEOUT, Sys Mgmt Util M-Z, 6-55 
SHOW ENVIRONMENT, Sys Mgmt Util 
M-Z, 6-56 

SHOW KEY, Sys Mgmt Util M-Z, 6-57 
SHOW PROFILE, Sys Mgmt Util M-Z, 

6-58 

SHOW TIME, Sys Mgmt Util M-Z, 6-58 
SHUTDOWN NODE, Sys Mgmt Util M-Z, 
6-59 


System Management utility (SYSMAN) 
commands (cont’d) 

SPAWN, Sys Mgmt Util M-Z, 6-62 
STARTUP ADD, Sys Mgmt Util M-Z, 6-65 
STARTUP DISABLE, Sys Mgmt Util M-Z 
6-67 

STARTUP ENABLE, Sys Mgmt Util M-Z 
6-68 

STARTUP MODIFY, Sys Mgmt Util M-Z 
6-69 

STARTUP REMOVE, Sys Mgmt Util M-Z 
6-70 

STARTUP SET DATABASE, Sys Mgmt 
Util M-Z, 6-71 

STARTUP SET OPTIONS, Sys Mgmt Util 
M-Z, 6-72 

STARTUP SHOW, Sys Mgmt Util M-Z, 
6-73 

SYS_LOADABLE ADD, Sys Mgmt Util 
M-Z, 6-74 

SYS_LOADABLE REMOVE, Sys Mgmt 
Util M-Z, 6-76 

common tasks, Sys Mgmt Util M-Z, 6-3 
executing a command procedure, Sys Mgmt 
Util M-Z, 6-9 

executing SYSMAN commands, Sys Mgmt Util 
M-Z, 6-4 

exiting from, Sys Mgmt Util M-Z, 6-5 
initialization file, Sys Mgmt Util M-Z, 6-4 
invoking, Sys Mgmt Util M-Z, 6-5 
overview, Sys Mgmt Util M-Z, 6-3 
privilege requirements, Sys Mgmt Util M-Z, 

6—5 

restrictions, Sys Mgmt Util M-Z, 6-5 
System overview statistics 

in Monitor utility, Sys Mgmt Util M-Z, 1-52 
System parameters 

See also AUTOGEN command procedure 
ACP, Sys Mgmt Util M-Z, C-6 to C-9 
affected by AUTOGEN calculations, Sys Mgmt 
Util A-L, 6-4 

affected by AUTOGEN feedback, Sys Mgmt 
Util A-L, 6-5 

categories, Sys Mgmt Util M-Z, C-l 
changing 

recommended method, Sys Mgmt Util A-L 
6-3 

checking, Sys Mgmt Util M-Z, 6-45 
checking AUTOGEN’s settings, Sys Mgmt Util 
A-L, 6-4 

default parameter file, Sys Mgmt Util A-L, 6-5 
6-7 

descriptions, Sys Mgmt Util M-Z, C-6 to C-57 
disabling checking, Sys Mgmt Util M-Z, 6-44 
displaying, Sys Mgmt Util M-Z, 6-47 

device configuration, Sys Mgmt Util M-Z 
5-24 
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System parameters 
displaying (cont’d) 

device driver addresses, Sys Mgmt Util 
M-Z, 5-28 

I/O subsystems, Sys Mgmt Util M-Z , 5—27 
parameter values, Sys Mgmt Util M-Z, 

5-20 

startup procedure, Sys Mgmt Util M-Z, 

5- 29 

UNIBUS I/O addresses, Sys Mgmt Util 
M-Z , 5-30 

values, Sys Mgmt Util M-Z, 5—20 
file 

See Parameter files 

Login security, Sys Mgmt Util M-Z, C—18 to 
C-19 

modifying, Sys Mgmt Util M-Z, 6—51 

recommended method, Sys Mgmt Util A-L, 

6— 3 

Process limits and quotas, Sys Mgmt Util M-Z, 
C-29 to C-31 

RMS, Sys Mgmt Util M-Z, C-33 to C-34 
setting, Sys Mgmt Util M-Z, 6—46 

parameter addresses, Sys Mgmt Util M-Z, 
5-15 

parameter values, Sys Mgmt Util M-Z, 

5- 3, 5-15, 5-20, 5-32, 5-33 
recommended method, Sys Mgmt Util A-L, 

6- 3 

sharing multiport memory, Sys Mgmt Util 
M-Z, 5-17 

showing, Sys Mgmt Util M-Z, 5—20 
specifying startup procedure, Sys Mgmt Util 
M-Z, 5-17, 5-32, 5-33 
summary, Sys Mgmt Util M-Z, C-2 
System Communications Services, Sys Mgmt 
Util M-Z, C-35 to C-36 
terminal behavior, Sys Mgmt Util M-Z, C-43 
to C-46 

VCC_FLAGS, Sys Mgmt Util M-Z, C-49 
VCC_FLAGS_D, Sys Mgmt Util M-Z, C-49 
VCC_FLAGS_S, Sys Mgmt Util M-Z, C-49 
VCCJMAXSIZE, Sys Mgmt Util M-Z, C-49 
VCC_MINSIZE, Sys Mgmt Util M-Z, C-49 
VMS, Sys Mgmt Util M-Z, C-56 
work area, Sys Mgmt Util M-Z, 6—50, 6—51 
writing contents of, Sys Mgmt Util M-Z, 6—51 
writing to file, Sys Mgmt Util M-Z, 5-33 
System passwords, Sys Mgmt Util A-L, 5-40 
/SYSTEM qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-36 
SYSTEMS class 

adding or restoring, Sys Mgmt Util M-Z, 4-31 
fields belonging to, Sys Mgmt Util M-Z, 4-27 
removing, Sys Mgmt Util M-Z, 4—46 
System shutdown 

to install changed system parameters, Sys 
Mgmt Util A-L, 6-8 


System time 

setting, Sys Mgmt Util M-Z, 6—16 
SYSTEM_CHECK system parameter, Sys Mgmt 
Util M-Z, C-40 
SYSUAF logical name 

defining, Sys Mgmt Util A-L, 5—5 
SYSUAFs (system user authorization files) 
creating, Sys Mgmt Util A-L, 5—3 
default directory entry, Sys Mgmt Util A-L, 

5-18 

default values, Sys Mgmt Util A-L, 5-18 
displaying records in, Sys Mgmt Util A-L, 5-46 
modifying, Sys Mgmt Util A-L, 5—3 
re-creating, Sys Mgmt Util A-L, 5—3 
renaming records, Sys Mgmt Util A-L, 5—43 
SYSJLOADABLE ADD command 

in SYSMAN, Sys Mgmt Util M-Z, 6-74 
SYS_LOADABLE REMOVE command 
in SYSMAN, Sys Mgmt Util M-Z, 6-76 

T__ 

TAILORED system parameter, Sys Mgmt Util 
M-Z, C-41 
Tape drive 

using /MEDIA_FORMAT qualifier, Sys Mgmt 
Util A-L, 7-46 

TAPE_ALLOCLASS system parameter, Sys Mgmt 
Util M-Z, C-41 

/TAPE_EXPIRATION qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-61 
TAPE _MVTIMEOUT system parameter, Sys 
Mgmt Util M-Z, C-41 

Target node name, Sys Mgmt Util A-L, 13-54 
Target port name, Sys Mgmt Util A-L, 13-54 
Target service name, Sys Mgmt Util A-L, 13—54 
TBSKIPWSL system parameter, Sys Mgmt Util 
M-Z, C-56 

TERMINAL command 

in SYSGEN, Sys Mgmt Util M-Z, 5-31 
Terminals 

modifying control-key echo strings, Sys Mgmt 
Util M-Z, 5-31 

sending alarm messages to, Sys Mgmt Util 
A-L, 1-6 

Terminating a session, Sys Mgmt Util A-L, 3-6 
Terse report 

example, Sys Mgmt Util A-L, 9—23 
TESTFILES phase of AUTOGEN, Sys Mgmt Util 
A-L, 6-7 
Time 

See also SYSMAN command CONFIGURATION 
SHOW TIME 

extracting records by, Sys Mgmt Util A-L, 4-5 
setting system, Sys Mgmt Util M-Z, 6—16 
updating in a VMScluster, Sys Mgmt Util M-Z, 
6-17 

VMScluster 
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Time 

VMScluster (cont’d) 

displaying, Sys Mgmt Util M-Z, 6-18 
Timeout period 

displaying, Sys Mgmt Util M-Z, 6-58 
setting, Sys Mgmt Util M-Z, 6-55 
TIMEPROMPTWAIT system parameter, Sys 
Mgmt Util M-Z, C-41 
Timers 

for circuits, Sys Mgmt Util A-L, 13-27 
for multicast message in LAT environment, 

Sys Mgmt Util A-L, 13-30 
setting in a LAT environment, Sys Mgmt Util 
A-L, 13-30 

TIME_CONTROL system parameter, Sys Mgmt 
Util M-Z, C-41 

TIMVCFAIL system parameter, Sys Mgmt Util 
M-Z, C-42 

TMSCP_LOAD system parameter, Sys Mgmt Util 
M-Z, C-42 

TMSCP_SERVE_ALL system parameter, Sys 
Mgmt Util M-Z, C-42 
TRANSACTION class record 

in Monitor utility, Sys Mgmt Util M-Z, A-41 
Transactions 

managing transaction logs, Sys Mgmt Util A-L 
14-1 

monitoring, Sys Mgmt Util M-Z, 1-55 
Trigger boot 

LANCP MOP downline load service, Sys Mgmt 
Util A-L, 12-40 
TRIGGER NODE command 

in LANCP utility, Sys Mgmt Util A-L, 12-40 
TR numbers 

display on Alpha systems, Sys Mgmt Util M-Z 
6-39 

/TRUNCATE qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-62 
TTY system parameters 

See also System parameters 
terminal behavior 

TTY_ALTALARM, Sys Mgmt Util M-Z, C-43 
TTY_ALTYPAHD, Sys Mgmt Util M-Z, C-43 
TTY_AUTOCHAR, Sys Mgmt Util M-Z, C-43 
TTY.BUF, Sys Mgmt Util M-Z, C-43 
TTY_CLASSNAME, Sys Mgmt Util M-Z, C—43 
TTY_DEFCHAR, Sys Mgmt Util M-Z, C-43 
TTY_DEFCHAR2, Sys Mgmt Util M-Z, C-44 
TTY_DEFPORT, Sys Mgmt Util M-Z, C-45 
TTY_DIALTYPE, Sys Mgmt Util M-Z, C-45 
TTY_DMASIZE, Sys Mgmt Util M-Z, C-45 
TTY_PARITY, Sys Mgmt Util M-Z, C-45 
TTY_RSPEED, Sys Mgmt Util M-Z, C-46 
TTY_SCANDELTA, Sys Mgmt Util M-Z, C-46 
TTY_SILOTIME, Sys Mgmt Util M-Z, C-46 
TTY_SPEED, Sys Mgmt Util M-Z, C-46 
TTY_TIMEOUT, Sys Mgmt Util M-Z, C-46 
TTY_TYPAHDSZ, Sys Mgmt Util M-Z, C-46 


TURBOchannel 

device on, Sys Mgmt Util M-Z, 5-29 

u 

UAFALTERNATE system parameter, Sys Mgmt 

Util M-Z, C-46 

UAFs (user authorization files) 

See SYSUAFs 

/UCS_SEQUENCE=(ESCAPE_SEQUENCE) 

qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-36 
UDABURSTRATE system parameter, Sys Mgmt 
Util M-Z, C-46 

UlC-based protection 
See Protection codes 
UICs (user identification codes) 

for disk quota file, Sys Mgmt Util M-Z, 6-21 
identifiers, Sys Mgmt Util A-L, 1-13 
specifying, Sys Mgmt Util M-Z, 2-29 
/UNDEFINED_FAT qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-37 
UNIBUS I/O addresses, Sys Mgmt Util M-Z, 5-30 
Unloading licenses, Sys Mgmt Util M-Z, 6-43 
/UNLOAD qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-38 
UPDATE DEVICE command 

in LANCP utility, Sys Mgmt Util A-L, 12-41 
Usage count 

updating, Sys Mgmt Util M-Z, 6-26 
/USAGE qualifier, Sys Mgmt Util A-L, 3-5, 3-11 
in Analyze/DiskjStructure utility, Sys Mgmt 
Util A-L, 3-11 
USE command 

in SYSGEN, Sys Mgmt Util M-Z, 5-32 
User (security category) 

controlling types of access, Sys Mgmt Util A-L 
1-13 

User accounts 

altering, Sys Mgmt Util A-L, 5-36 
creating, Sys Mgmt Util A-L, 5-8 
deleting, Sys Mgmt Util A-L, 5-41 
User directories 

creating for a new account, Sys Mgmt Util A-L 
5-19 

User identification codes 
See UICs 
User names 

as identifiers, Sys Mgmt Util A-L, 1-13 
identifiers added with, Sys Mgmt Util A-L 
5-19 

specifying with wildcards, Sys Mgmt Util A-L 
5-6 

USER system parameters 

USER3, Sys Mgmt Util M-Z, C-47 
USER4, Sys Mgmt Util M-Z, C-47 
USERD1, Sys Mgmt Util M-Z, C-46 
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USER system parameters (cont’d) 

USERD2, Sys Mgmt Util M-Z, C-47 

v____ 

VAXCLUSTER system parameter, Sys Mgmt Util 

M-Z, C-47 

VAXVMSSYS.OLD file, Sys Mgmt Util A-L, 6-7 
VAXVMSSYS.PAR file, Sys Mgmt Util A-L, 6-7 
VBS class record 

in Monitor utility, Sys Mgmt Util M-Z, A-44 
VBSS_ENABLE2 system parameter, Sys Mgmt 
Util M-Z, C-48 

VBSS_ENABLE system parameter, Sys Mgmt 
Util M-Z, C-48 

VCC_FLAGS system parameter, Sys Mgmt Util 
M-Z, C-49 

VCC_FLAGS_D system parameter, Sys Mgmt 
Util M-Z, C-49 

VCC_FLAGS_S system parameter, Sys Mgmt Util 
M-Z, C-49 

VCC_MAXSIZE system parameter, Sys Mgmt 
Util M-Z, C-49 

VCC_MINSIZE system parameter, Sys Mgmt Util 
M-Z, C-49 

VCC_PTES system parameter, Sys Mgmt Util 
M-Z, C-49 

VECTOR class record 

in Monitor utility, Sys Mgmt Util M-Z, A-45 
Vector CPU time 

obtaining information regarding processor, Sys 
Mgmt Util M-Z , A-45 

obtaining information regarding system, Sys 
Mgmt Util M-Z , A-45 
Vector processing 

monitoring, Sys Mgmt Util M-Z , 1—58 
Vector quantum adjustment disabling option, Sys 
Mgmt Util M-Z , C—34 
Vectors 

addresses, Sys Mgmt Util M-Z , 5—7, 5—9 
fixed space, Sys Mgmt Util M-Z , D—1 
floating space, Sys Mgmt Util M-Z , D—1 
VECTORJVLARGIN system parameter, Sys Mgmt 
Util M-Z , C-49 

VECTOR_PROC system parameter, Sys Mgmt 
Util M-Z, C-49 
Verification 

of disk volumes, Sys Mgmt Util A-L, 3-3 
/VERIFY qualifier 

in Backup utility, Sys Mgmt Util A-L, 7-62 
/VIEWING_TIME qualifier 

in Monitor utility, Sys Mgmt Util M-Z, 1—13 
VIRTUALPAGECNT system parameter, Sys 
Mgmt Util M-Z, C-50 
VMS$SYSTEM_IMAGES.IDX 

adding an entry, Sys Mgmt Util M-Z, 6-75 
removing an entry, Sys Mgmt Util M-Z, 6—76 


VMScluster environments 

command execution, Sys Mgmt Util M-Z, 6-30 
DCL commands interacting with SYSMAN 
cluster commands, Sys Mgmt Util M-Z, 

6-6 

displaying group number, Sys Mgmt Util M-Z, 
6-17 

displaying multicast address, Sys Mgmt Util 
M-Z, 6-17 

displaying network information, Sys Mgmt Util 
M-Z, 6-17 

displaying system date and time, Sys Mgmt 
Util M-Z, 6-18 

dual-architecture 

installing images, Sys Mgmt Util M-Z, 

6-30, 6-31 

group number, Sys Mgmt Util M-Z, 6—15 
modifying security data, Sys Mgmt Util M-Z, 
6-15 

password, Sys Mgmt Util M-Z, 6-15 
setting time, Sys Mgmt Util M-Z, 6-16 
updating security data, Sys Mgmt Util M-Z, 
6-15 

VMSIMAGES.DAT file, Sys Mgmt Util A-L, 6-7 
VMS system parameters 
See System parameters 
/VOLUME qualifier 

in Backup utility, Sys Mgmt Util A-L, 7—63 
Volume quota file 
See Disk quotas 
Volumes 

See also Disk volumes 
See also Magnetic tape 

allocating map pointers for file windows, Sys 
Mgmt Util M-Z, 2-39 
dismounting, Sys Mgmt Util M-Z, 2-38 
making for group, Sys Mgmt Util M-Z, 2-21 
mounting, Sys Mgmt Util M-Z, 2-4 

from a subprocess, Sys Mgmt Util M-Z, 

2-3 

mounting foreign, Sys Mgmt Util M-Z, 2-20 
mounting with operator assistance, Sys Mgmt 
Util M-Z, 2-8 

mounting with shadowing, Sys Mgmt Util M-Z, 
2-16, 2-17 

nonstandard format, Sys Mgmt Util M-Z, 2-20 
ownership, Sys Mgmt Util M-Z, 2—36 
protection 

mounting with shadowing, Sys Mgmt Util 
M-Z, 2-34 

ownership, Sys Mgmt Util M-Z, 2—29 
processor, Sys Mgmt Util M-Z, 2—30 
recovery, Sys Mgmt Util M-Z, 2—32 
user quotas, Sys Mgmt Util M-Z, 2—32 
with MOUNT command, Sys Mgmt Util 
M-Z, 2-27, 2-31, 2-39 

public 
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Volumes 

public (cont’d) 

creating, Sys Mgmt Util M-Z, 2-36 
repairing errors on a disk volume, Sys Mgmt 
Util A-L, 3-11 

sharing, Sys Mgmt Util M-Z, 2-35 
standard ANSI and Files-11 format, Sys Mgmt 
Util M-Z, 2-23 

write protection, Sys Mgmt Util M-Z, 2-39 
Volume sets 

adding a volume to, Sys Mgmt Util M-Z, 2-11 
and MOUNT command, Sys Mgmt Util M-Z 
2-5 

creating, Sys Mgmt Util M-Z, 2-11 
image save operation, Sys Mgmt Util A-L, 7-36 
VOTES system parameter, Sys Mgmt Util M-Z 
C-50 


w 

Wildcard characters, Sys Mgmt Util A-L, 7-8 

restriction in ACL editor, Sys Mgmt Util A-L 
1-4 

using to represent directories, Sys Mgmt Util 
A-L, 7-8 
Windows 

compressing or expanding, Sys Mgmt Util M-Z 
4-54 

designating, Sys Mgmt Util M-Z, 4-50 
display SHOW CLUSTER information, Sys 
Mgmt Util M-Z, 4-3 
moving, Sys Mgmt Util M-Z, 4-51 
rearranging, Sys Mgmt Util M-Z, 4-37 
scrolling, Sys Mgmt Util M-Z, 4-49 
terminating selection, Sys Mgmt Util M-Z 
4-35 

viewing large display, Sys Mgmt Util M-Z, 

4-39 

/WINDOWS qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-39 
WINDOW_SYSTEM system parameter, Sys Mgmt 
Util M-Z, C-50 
Work area 

copying to parameter file, Sys Mgmt Util M-Z 
6-51 

loading parameters, Sys Mgmt Util M-Z, 6-50 
WPRE_SIZE system parameter, Sys Mgmt Util 
M-Z, C-51 

WPTTE_SIZE system parameter, Sys Mgmt Util 
M-Z, C-51 

WRITABLESYS system parameter, Sys Mgmt 
Util M-Z, C-56 
WRITE command 

in Show Cluster utility, Sys Mgmt Util M-Z 
4-55 

in SYSGEN, Sys Mgmt Util M-Z, 5-33 


/WRITE qualifier 

in Mount utility, Sys Mgmt Util M-Z, 2-39 
WRITESYSPARAMS system parameter, Sys 
Mgmt Util M-Z, C-56 

WSDEC system parameter, Sys Mgmt Util M-Z, 


WSINC system parameter, 
C-51 


Sys Mgmt Util M-Z, 


WSMAX system parameter, Sys Mgmt Util M-Z 
C-51 

WS_OPAO system parameter, Sys Mgmt Util M-Z 
C-51 


XFMAXRATE system parameter, Sys Mgmt Util 

M-Z, C-52 

XQPCTL2 system parameter, Sys Mgmt Util M-Z 
C-56 

XQPCTLD1 system parameter, Sys Mgmt Util 
M-Z, C-57 


Z_ 

ZERO COUNTERS command 

in LATCP, Sys Mgmt Util A-L, 13-60 
ZERO_LIST_HI system parameter, Sys Mgmt 
Util M-Z, C-52 
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